op_ici_destroy()
摘要
释放指定的 ICI,将其关联的内存资源释放出来供其他用途。
语法
op_ici_destroy (iciptr)
| 参数 | 类型 | 说明 |
|---|---|---|
iciptr |
Ici * |
指向目标 ICI 的指针 [指向 ICI 的指针可以从两个内核过程获得: op_ici_create() 返回指向新分配 ICI 的指针(在 ICI 发送进程中),以及 op_intrpt_ici() 返回与传入中断关联的 ICI 的指针(在 ICI 接收进程中)。] |
返回类型
void
无返回值。
示例
摘自:示例模型(models\std\x25);进程模型(x25_dte_rt);状态 “startup”。
/* The DTE is trying to open the data link. */
switch (op_intrpt_type ())
{
case OPC_INTRPT_REMOTE:
/* Check for ICI indicating link established. */
if ((iciptr = op_intrpt_ici ()) != OPC_NIL);
{
op_ici_attr_get (iciptr, "primitive", &primitive);
if (primitive == OSIC_DL_CONNECT_INDICATION)
{
x25_dte_trace_msg ("Data link connection established");
timer_stop (&timer);
link_alive = 1;
timer.delay = mod_vars.mv_timer_value [X25C_T20];
timer.code = X25C_T20;
}
/* The ICI’s contents have been extracted so it can be discarded. */
op_ici_destroy (iciptr);
}
详情
当某个特定的 ICI 不再被访问或安装时,应为其分配的内存资源释放出来,供创建新 ICI 时重复使用。若不将未使用的 ICI 内存释放给仿真内核,可能导致未释放的 ICI 不断累积。当仿真达到最大虚拟内存用量且无法满足新对象的分配请求时,这可能最终导致仿真中止。
用途
为不再使用的 ICI 所关联的内存提供了一种“回收”机制。仿真内核可以根据进行中的仿真的需要,将这些内存分配给其他动态对象。每当某个 ICI 要从进程的访问中移除时,都应调用该内核过程。调用该内核过程之后,指定的 ICI 指针应被视为无效(即不能再被引用或传递给内核过程)。
错误
- 程序中止:Segmentation violation(由于无效的 ICI 指针或格式错误的 ICI 数据结构)。
- 可恢复错误:ICI 指针为 NIL。
参考
- 使用内核过程 op_ici_create() 执行相反操作,创建一个 ICI
- 使用内核过程 op_intrpt_ici() 获取与传入中断关联的 ICI 指针
- 使用内核过程 op_ici_attr_set_dbl()、op_ici_attr_set_int32()、op_ici_attr_set_int64() 和 op_ici_attr_set_ptr() 为 ICI 属性赋值
- 使用内核过程 op_ici_install() 安装 ICI 以与传出中断关联