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 中无法识别。

参考

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