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