op_esys_interface_vector_set()
摘要
从值向量设置向量接口的各连续值。
语法
op_esys_interface_vector_set (interface, schedule_time, source, start_offset)
| 参数 | 类型 | 说明 |
|---|---|---|
interface |
Esys_Interface |
将被设置其值的向量接口的 esys 接口 ID [该 esys 接口必须是向量接口。可以从 Topo 包和 Id 包中的多个内核过程获取 esys 接口 ID,包括 op_topo_child() 和 op_id_from_name()。] |
schedule_time |
double |
将数据写入向量接口的计划时间(可用常量见「详情」小节) |
source |
Vvec_Vector |
用于设置向量接口的值向量 [向量接口与值向量的类型必须匹配,且必须具有相同的维数。] |
start_offset |
int |
开始从源向量读取值的位置 [指定位置中的值将被放置到向量接口的第一个位置(索引 0)。随后值向量的每个元素依次读取到向量接口的后续位置。这些位置中已存在的任何值都会被覆盖。] |
返回类型
Evhandle
已计划用于设置该接口的 OPC_INTRPT_ESYS_INTERFACE_EXT 中断的句柄(若已计划);否则为 OPC_NIL。
示例
/* Send some data to an esys interface. Extract lower-order 16 bits from 'vvec' vector. */
head = op_vvec_remove (vvec, OPC_VVEC_VECTOR_START, 16);
/* Schedule values on the esys vector interface. */
op_esys_interface_vector_set (interface_id, op_sim_time(), head, 0);
/* Done with this vector. */
op_vvec_destroy (head);
详情
start_offset 的值指的是值向量的索引,而不是向量接口。因此,将 start_offset 设为 5 时,向量接口的第一个元素(索引 0)将被设置为值向量第六个位置(索引 5)中的值。此后,向量接口的第二个元素将被设置为值向量第七个位置中的值,依此类推,直到向量接口的所有值都被设置完毕。
值向量必须足够长,能够填满向量接口的所有元素,因为 op_esys_interface_vector_set() 在向量接口的所有值都被设置完毕之前不会停止读取。
schedule_time 参数可以是显式时间,也可以是下列特殊值之一:
OPC_ESYS_NOTIFY_IMMEDIATELY——接口值立即传递给已注册的回调(如果有)OPC_ESYS_NOTIFY_NEVER——接口值被更新,但不会调用已注册的回调
用途
提供了一种将值向量的内容写入向量接口的机制。
错误
- 程序中止:段错误。(由于无效的向量参数)
- 可恢复错误:接口句柄无效。
- 可恢复错误:输入向量无效。
- 可恢复错误:试图在 esys 输入接口(
<id>)上设置值。 - 可恢复错误:试图在非向量接口(
<id>)上设置向量或数组值。 - 可恢复错误:输入 Vvec 向量的类型(
<type>)与接口类型(<type>)不匹配。 - 可恢复错误:指定的时间(
<schedule_time>)小于当前时间。
参考
- 使用内核过程 op_intrpt_esys_interface() 获取 esys 接口的 esys 接口 ID
- 使用内核过程 op_esys_interface_vector_get() 将向量接口的内容放入值向量
- 使用内核过程 op_esys_interface_array_set() 将数组中的元素放置到向量接口上
- 使用内核过程 op_esys_interface_value_set() 将单个变量的值放置到 esys 接口上
- 使用内核过程 op_vvec_create() 创建值向量
- 使用内核过程 op_vvec_type_get() 确定向量的数据类型