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。

参考

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