op_pro_invoker()
摘要
判断一个活动进程是由内核调用(直接模式)还是由另一个进程调用(间接模式)。在间接模式下,返回调用方进程的进程句柄。
语法
op_pro_invoker (pro_handle, invnode_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pro_handle |
Prohandle |
需要确定其调用者的进程的进程句柄 |
invnode_ptr |
int* |
输出参数(将被修改的整数的地址)。 该内核过程返回时,所引用的整数包含一个值,指示该进程是由内核直接调用来处理中断,还是由另一个进程通过内核过程 op_pro_invoke() 间接调用。若指定进程被直接调用,该值为常量 OPC_PROINV_DIRECT;若该进程通过 op_pro_invoke() 被调用,则写入值 OPC_PROINV_INDIRECT。值 OPC_PROINV_ERROR 用于指示该内核过程未能完成(参见错误一节) |
返回类型
Prohandle
调用了指定进程的进程的进程句柄,该进程由本内核过程的 pro_handle 参数指定。若发生错误,或指定进程是由内核直接调用来处理当前中断,则该进程句柄无效。
示例
/* Make sure that we have arrived here as a result of a stream interrupt. */
if (op_intrpt_type () == OPC_INTRPT_STRM)
{
/* Determine if this process is the first to be invoked to handle the current intrpt. */
invoker_ph = op_pro_invoker (op_pro_self (), &inv_mode);
/* If the process is the first, then acquire the arriving packet. */
if (inv_mode == OPC_PROINV_DIRECT)
pkptr = op_pk_get (op_intrpt_strm ());
/* Otherwise, get the packet from the args passed by the invoking process. */
else
{
pkptr = (Packet*) op_pro_argmem_access ();
/* Schedule a process interrupt for the invoking process in HOLD_TIME sec. */
/* (this is the time at which the packet's delay has elapsed. */
op_intrpt_schedule_process (invoker_ph, op_sim_time () + HOLD_TIME, PK_ELAPSED);
}
/* Enqueue the received packet (regardless of invocation mode). */
详情
该内核过程通常用于分析当前正在执行的进程(即调用该内核过程的进程)的调用情况。不过,它也可用于确定由 pro_handle 参数指定的任何活动进程的调用模式和调用者。活动进程指已被调用且尚未从调用中返回的任何进程。在若干进程通过 op_pro_invoke() 依次相互调用的情况下,可将该内核过程递归地应用于返回的进程句柄,从而沿着完整的调用"栈"回溯到中断的起点。
用途
该内核过程通常用于区分两种调用:仿真内核响应外围模块的中断而直接发起的调用(直接模式),以及另一个进程通过 op_pro_invoke() 发起的调用(间接模式)。这一信息无法通过 Intrpt 包中的任何内核过程获得,因为单个中断内可能发生多次调用,而与中断相关的信息在单个事件期间保持不变。该信息可用于判断一次调用的意义以及应当进行何种处理。对于间接调用,还可以确定调用方进程,以便在被调用进程存在多个潜在调用者时,让它能够以某种方式作出响应。
错误
- 程序中止:段违例(由于进程句柄格式错误,或
invmode_ptr输出参数的地址无效)。 - 可恢复错误:进程句柄无效。
- 可恢复错误:进程句柄指向已被销毁的进程(
<proc_id>)。
参考
- 使用内核过程 op_pro_parent() 获取某进程之父进程的进程句柄
- 使用内核过程 op_pro_create() 创建新进程并获取其进程句柄
- 使用内核过程 op_pro_invoke() 调用同一外围模块中的另一个进程
- 使用内核过程 op_pro_root() 获取外围模块根进程的进程句柄
- 使用内核过程 op_pro_id() 根据进程句柄获取进程的唯一标识符
- 使用内核过程 op_pro_self() 获取当前正在执行进程的进程句柄