op_pro_create()
摘要
创建指定进程模型的一个新进程实例,并允许安装父子共享内存,作为当前进程与所创建子进程之间的通信机制。
语法
op_pro_create (model_name, ptc_mem_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
model_name |
const char* |
要实例化的进程模型的名称 [所选的进程模型必须通过直接指派给处理器或队列,或作为另一个已纳入进程模型的子进程被引用来纳入整体模型。] |
ptc_mem_ptr |
void* |
要由当前进程与新创建进程共享的父子内存块的地址 [该内存块的格式由用户定义;约定是,如果当前进程与子进程之间不共享内存,则应传入值 OPC_NIL。] |
返回类型
Prohandle
用于对已创建的子进程执行后续操作的进程句柄。
示例
/* Select a port number for a new session being initiated. */
port_num = tp_port_select ();
/* Create a session-status data structure to allow */
/* communication between this (root) process and the */
/* session process about to be created. */
ss_ptr = op_prg_mem_alloc (sizeof (Tp_Session_Status));
/* Set up information needed by the session process. */
ss_ptr->dest_host = dest_host;
ss_ptr->dest_port = dest_port;
/* Create a new process to manage the session and retain */
/* its handle in the session process table. */
tp_sess_proc_table [port_num] = op_pro_create (“tp_session”, ss_ptr);
/* Invoke the process for its initialization (op_pro_create() */
/* does not automatically invoke the child process) */
op_pro_invoke (tp_sess_proc_table [port_num], OPC_NIL);
详情
仿真内核支持在单个队列或处理器模块内并发存在任意数量的各种类型的进程。除根进程外,所有这些进程都通过内核过程 op_pro_create() 创建。只有当传入的参数 process_model 指向已在当前执行的仿真中声明存在的进程时,该内核过程才会成功。当进程模型被指派给仿真系统中任何处理器或队列模块的进程模型属性时,即隐式完成了该进程模型的声明;或者,一个进程可以通过进程编辑器中的声明机制被声明为另一个进程的子进程。
每个通过 op_pro_create() 创建的进程都可以(由父进程自行选择)利用共享内存与创建它的进程通信。共享内存是一个用户定义的内存块,其地址必须作为该内核过程的参数 ptc_mem_ptr 传入。这是这对进程建立父子共享内存的唯一时机。子进程可以通过调用过程 op_pro_parmem_access() 获得经此机制建立的地址。
按照约定,如果父进程在创建子进程时不希望提供共享内存,则应为 ptc_mem_ptr 的值传入符号常量 OPC_NIL。
用途
使进程能够在同一模块内创建子进程。每个子进程作为进程模型的一个独立实例存在,维护自己的状态。
错误
- 程序中止:内核过程要求进程上下文。
- 程序中止:无法创建进程(
<model_name>)。 - 程序中止:进程(
<model_name>)的描述符分配失败。 - 程序中止:进程(
<model_name>)的初始化失败。 - 可恢复错误:进程模型(
<model_name>)未声明。
参考
- 使用内核过程 op_pro_invoke() 调用一个进程模型
- 使用内核过程 op_pro_parmem_access() 让子进程获取父子共享内存
- 使用内核过程 op_pro_id() 确定进程的唯一整数标识符