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() 获取当前正在执行进程的进程句柄

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