op_pro_invoke()

摘要

在当前事件和当前模块的上下文中调用一个进程。调用方进程将被挂起,直到该内核过程返回。

语法

op_pro_invoke (pro_handle, argmem_ptr)
参数 类型 说明
pro_handle Prohandle 要被调用的进程的进程句柄
argmem_ptr void* 参数内存块的地址,该内存块将通过 op_pro_argmem_access() 供被调用的进程使用。若不使用参数内存则为 OPC_NIL。

返回类型

Compcode

指示调用是否成功完成的完成代码。调用方进程可以将该代码与常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。失败的原因包括进程句柄已失效,以及调用了属于其他模块的进程。

示例

摘自:示例模型(models/std/x25);进程模型(x25_dte_root);状态(r1);出口执行。

/* Create the new channel. */
chan_ptr = x25_channel_create (channel_root, i);
chan_ptr->permanent = 0;

/* Initialize its address information and stream indices. */
x25_channel_init (chan_ptr, local_addr, remote_addr, X25C_DTE_DL_OUTSTRM, pk_strm);

/* Create the process for this channel. Share the channel data structure with it. */
chan_ptr->process = op_pro_create ("x25_dte_chan", chan_ptr);

/* Invoke the channel process so that it can initialize itself. */
/* No arguments are needed for the initialization. */
op_pro_invoke (chan_ptr->process, OPC_NIL);

/* Invoke the channel process again so it can actually handle the call indication.*/
/* Include the call's first packet as an argument. */
op_pro_invoke (chan_ptr, pkptr);

详情

该内核过程将某个进程作为当前正在执行的进程(父进程)的子进程来调用。对子进程的调用发生在父进程的中断上下文中,不会向队列中放入新事件。一个进程可以调用由同一模块(即当前正在执行的模块)拥有的任何其他进程。若以属于其他模块的进程的进程句柄调用 op_pro_invoke(),将导致可恢复错误。

在单个事件期间对 op_pro_invoke() 的调用次数没有限制。换言之,因调用 op_pro_invoke() 而被中断的进程,又可以通过同一内核过程调用另一个进程。以这种方式被调用的一系列进程称为当前调用栈(类似于函数调用栈)。仿真内核限制进程调用当前调用栈中的其他进程。这意味着一个进程不能调用处于活动状态的进程,例如:

  • 直接调用它的进程(其父进程)
  • 调用其父进程的进程
  • 它自身

注意进程实例与进程模型是有区别的。因此,调用与当前进程同类型的另一个进程是可行的,但不能调用完全相同的进程实例。

当发生调用时,调用方进程可以设置一块由它自己与被调用进程共享的内存。这块内存称为参数内存,因为它用于向被调用进程传入和从其传出参数。参数内存在整个被调用进程的存续期间都可用。内存块的地址必须作为参数提供给 op_pro_invoke()。被调用进程可以通过调用 op_pro_argmem_access() 获取该地址。

用途

可以设计多个进程协作处理发生在单个队列或处理器模块上下文中的事件。通常,这些进程以层次方式组织,父进程根据事件的需要将事件处理任务"移交"给合适的子进程。也可以采用其他组织方式,让进程按职能划分任务。例如,可以根据根进程收到的中断类型调用不同的子进程。大多数组织策略的共同点是:需要在模块内临时将执行控制权传递给子进程或同级进程。这通过调用内核过程 op_pro_invoke() 并提供应当执行的进程的进程句柄来实现。

错误

  • 程序中止:内核过程需要进程上下文。
  • 程序中止:段违例(由于进程句柄格式错误)。
  • 可恢复错误:进程句柄无效。
  • 可恢复错误:进程句柄指向已被销毁的进程(<proc_id>)。
  • 可恢复错误:进程句柄指向远程进程(<proc_id>)。
  • 可恢复错误:进程句柄指向处于活动状态的进程(<proc_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