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>)小于当前时间。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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