op_pro_id()

摘要

获取进程的唯一整数标识符。

语法

op_pro_id (pro_handle)
参数 类型 说明
pro_handle Prohandle 需要获取其唯一 id 的进程的进程句柄。

返回类型

int

由参数 pro_handle 指定的进程的唯一整数标识符。该标识符由仿真内核在进程创建时分配。若发生错误,返回值将是符号常量 OPC_PRO_ID_INVALID。

示例

/* Loop through the list of channels and create each channel's */
/* packet handling process. */
for (i = 0; i < num_channels; i++)
	{
	/* Obtain the i_th channel data structure. */
	chan_ptr = (Channel*) op_prg_list_access (Channel_List_Ptr, i);

	/* Create a process to handle packet arrives on this channel; */
	/* retain a handle for the process to invoke it when needed. */
	chan_ptr->pro_handle = op_pro_create ("chan_pkt_hndlr", OPC_NIL);

	/* If a trace is enabled for the simulation debugger, print the */
	/* id of the process next to the channel index. */
	if (op_prg_odb_ltrace_active ("channels"))
		{
		sprintf (str, "%d) pro_id = (%d)", i, op_pro_id (chan_ptr->pro_handle));
		op_prg_odb_print_minor (str, OPC_NIL);
		}
	}

详情

进程是进程模型的实例,或者由仿真内核在仿真开始时自动创建,或者由其他进程通过内核过程 op_pro_create() 动态创建。每个进程都带有一个唯一的整数 ID,可用于将它与仿真中的任何其他进程(包括属于其他模块的进程)区分开。该 ID 由仿真内核在进程创建时分配。

每个进程句柄都携带其所指进程的 ID。因此每个已初始化的进程句柄(即已被赋值为某个内核过程返回值的句柄)都携带有意义的进程 ID。那些因由执行出错的内核过程返回而无效的进程句柄,其进程 ID 等于符号常量 OPC_PRO_ID_INVALID。与大多数以进程句柄作为输入参数的其他内核过程不同,op_pro_id() 能够为已被销毁的进程正确返回进程 ID;尽管该进程不再活动,其 ID 仍可能用于报告目的,或用于与存储在应用专用数据结构中的进程 ID 进行比较。

用途

提供对进程唯一整数标识符的访问,通常用于打印调试或跟踪记录语句。

错误

  • 可恢复错误:进程句柄无效。
  • 程序中止:段违例(由于进程句柄格式错误)。

参考

  • 使用内核过程 op_pro_create() 创建新进程
  • 使用内核过程 op_pro_parent() 获取创建了另一进程的进程的进程句柄
  • 使用内核过程 op_pro_root() 获取队列/处理器根进程的进程句柄
  • 使用内核过程 op_pro_self() 获取当前正在执行的进程的进程句柄
  • 使用内核过程 op_pro_mod_objid() 确定拥有某进程的模块的对象 id

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