op_ici_attr_get_int32()
摘要
获取指定 ICI 中 32 位整数属性的值。
语法
op_ici_attr_get_int32 (iciptr, attr_name, value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
iciptr |
Ici * |
指向目标 ICI 的指针 [指向 ICI 的指针可以从两个内核过程获得: op_ici_create() 返回指向新分配 ICI 的指针(在 ICI 发送进程中),以及 op_intrpt_ici() 返回与传入中断关联的 ICI 的指针(在 ICI 接收进程中)。] |
attr_name |
const char * |
目标属性的名称 |
value_ptr |
OpT_Int32 * |
指向某个变量的指针,该变量将被填入指定属性的值 |
返回类型
Compcode
如果成功获取属性值,返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。
示例
OpT_Int32 AAL1_Structured_Data_Size;
/* Copy the contents of the ICI into the created data structure. */
op_ici_attr_get_int32 (aal_params_iciptr, "SDT block size",
&AAL1_Structured_Data_Size);
详情
指定的属性名称必须是作为 iciptr 参数所指 ICI 之基础的 ICI 格式中所定义的属性之一。注意,该内核过程获取的值是该 ICI 中指定属性的当前内容,而不是 ICI 被安装时或关联中断被安排时该属性的内容。
进程模型通过指针操作 ICI,与数据包不同,ICI 没有所有权的概念。这意味着多个进程模型可能同时合法地访问同一个 ICI 数据结构,并相互干扰对属性的使用。另一个常见问题发生在同一个 ICI 与多个事件关联使用时。需要重要的是认识到:虽然一个 ICI 可以与多个事件关联,但为后续事件而对 ICI 所做的修改,也可能影响该 ICI 在较早事件期间的用法——如果修改发生时这些较早事件尚未发生。例如,如果一个进程创建了一个 ICI、为其属性赋值、将其安装、发送出一个数据包,然后在数据包被接收之前修改了该 ICI 的某个属性,那么当接收该数据包的进程模型通过该内核过程访问该 ICI 时,提供的将是修改后的值。
用途
为收到了带有关联 ICI 的中断的进程提供了一种确定该 ICI 的 32 位整数属性值的机制。这一能力构成了进程之间基于 ICI 通信的“接收”端。另需注意,由于单个 ICI 可由多个进程共享,它可用于多方通信:接收中断的进程既从 ICI 中获取某些控制信息,也可以通过在同一个 ICI 中设置属性来返回信息。当与强制中断(forced interrupt)结合使用时,这是一种特别有用的技术,因为发起进程可以立即访问返回的值。
错误
- 程序中止:Segmentation violation(由于无效的 ICI 指针、格式错误的 ICI 数据结构,或声明不正确的
value_ptr参数)。 - 可恢复错误:属性名称(
<attr_name>)在格式为(<format_name>)的 ICI 中无法识别。
参考
- 使用内核过程 op_intrpt_ici() 获取与传入中断关联的 ICI 指针
- 使用内核过程 op_ici_attr_get_dbl() 获取指定 ICI 中 double 类型属性的值
- 使用内核过程 op_ici_attr_get_int64() 获取指定 ICI 中 64 位整数属性的值
- 使用内核过程 op_ici_attr_get_ptr() 获取指定 ICI 中指针属性的值