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>)小于当前时间。
参考
- 使用内核过程 op_intrpt_esys_interface() 获取某个 esys 接口的接口 ID
- 使用内核过程 op_esys_interface_array_get() 将向量接口中的元素放入已有数组
- 使用内核过程 op_esys_interface_value_set() 将单个变量的值放置到 esys 接口上
- 使用内核过程 op_esys_interface_vector_set() 将值向量中的元素放置到向量接口上