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