op_esys_interface_value_set()

摘要

向 esys 接口或向量接口的指定元素写入单个值。

语法

op_esys_interface_value_set (interface, schedule_time, value, index)
参数 类型 说明
interface Esys_Interface 待设置其值的 esys 接口的接口 ID 该 esys 接口可以是向量接口或非向量接口。可以通过 Topo 包和 Id 包中的若干内核过程(包括 op_topo_child() 和 op_id_from_name())获取 esys 接口 ID。]
schedule_time double 计划将数据写入 esys 接口的时间(关于可用的常量,参见「详情」)
value void* 要放置到 esys 接口上的值 [该参数可以接受任意标准 C 数据类型。该值的数据类型必须与待设置的 esys 接口的数据类型一致。]
index int 待设置的向量接口元素 [如果 esys 接口是向量接口,则该参数为必需;否则它仅作为占位符处理。]

返回类型

Evhandle

计划用于设置该接口的 OPC_INTRPT_ESYS_INTERFACE_EXT 中断的句柄(若已计划该中断);否则为 OPC_NIL。

示例

/* lock driver. */
if (op_intrpt_type () == OPC_INTRPT_SELF)
	{
	switch (op_intrpt_code ())
		{
		case CLOCK_HIGH:
		/* Assert clock signal at the current simulation time. */
		op_esys_interface_value_set (clock_interface, op_sim_time (), '1', 0);
		/* Schedule for the signal to be deasserted after 100 ns. */
		op_esys_interface_value_set (clock_interface, op_sim_time () + (1e-7),
			'1', 0);
		break;
		}
	}

详情

该过程在应用的事件列表上放置一个事件。在计划的时间点,value 出现在指定的 esys 接口或向量接口元素上。

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

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

用途

提供一种向 esys 接口写入单个值的机制。

错误

  • 程序中止:段违例。(由于 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