op_esys_interface_array_set()

摘要

使用数组设置向量接口的值。

语法

op_esys_interface_array_set (interface, schedule_time, array, start_offset)
参数 类型 说明
interface Esys_Interface 数据将写入的目标向量接口的 esys 接口 ID [可以通过 Topo 包和 Id 包中的若干内核过程(如 op_topo_child() 和 op_id_from_name())获取 esys 接口 ID。]
schedule_time double 将数据写入向量接口的计划时间(可用常量参见详情部分)
array void* 指向源数组的指针 该数组的元素数量必须不少于向量接口。它可以有更多元素,从而允许使用数组的一部分来设置向量接口。]
start_offset int 数组中将写入向量接口的第一个元素的索引 [数组的第一个元素不必是要设置到向量接口上的第一个值。该参数指定数组的哪个元素写入向量接口的 0 号位置。随后依次读取数组的后续元素到向量接口的后续位置,直到向量接口被填满。]

返回类型

Evhandle

若已安排用于设置接口的 OPC_INTRPT_ESYS_INTERFACE_EXT 中断,则返回其句柄;否则返回 OPC_NIL。

示例

/*	Read data to be applied to the vector interface from a file.	*/
	data_array = (int *) op_prg_mem_alloc (interface_width * (sizeof (int)));
	for (i = 0; i < interface_width; i++)
		{
		fscanf (file_ptr, "%d", data_array + i);
		}
/*	After the array has been read in, send the data to the vector interface */
/*	at the current simulation time. */
op_esys_interface_array_set (interface_id, op_sim_time (), data_array, 0);
/* Deallocate the array. */
op_prg_mem_free (data_array);

详情

start_offset 的值指的是数组的索引,而不是向量接口。因此,将 start_offset 设为 5 时,向量接口的第一个元素(索引 0)将被设置为数组第六个位置(索引 5)的值。此后,向量接口的第二个元素将被设置为数组第七个位置的值,依此类推,直到向量接口的所有值都被设置完毕。

数组必须足够长,能够填满向量接口的所有元素,因为 op_esys_interface_array_set() 在向量接口的所有元素都被设置完毕之前不会停止从内存读取值。

schedule_time 参数可以是一个明确的时间,也可以是下列特殊值之一:

  • OPC_ESYS_NOTIFY_IMMEDIATELY——接口值立即传递给已注册的回调(如果有)
  • OPC_ESYS_NOTIFY_NEVER——接口值被更新,但不会调用已注册的回调

用途

提供一种使用数组设置向量接口值的机制。

错误

  • 程序中止:段违例。(由于数组指针参数分配不当)
  • 程序中止:段违例。(由于 esys 接口数据类型与值不兼容)
  • 可恢复错误:接口句柄无效。
  • 可恢复错误:试图在 esys 输入接口(<id>)上设置值。
  • 可恢复错误:试图在非向量接口(<id>)上设置向量或数组值。
  • 可恢复错误:试图在未连接的 esys 接口(<id>)上设置值。
  • 可恢复错误:内存不足,无法在 esys 接口(<id>)上设置值。
  • 可恢复错误:指定时间(<schedule_time>)小于当前时间。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com