op_pro_destroy()
摘要
销毁一个动态创建的进程。
语法
op_pro_destroy (pro_handle)
| 参数 | 类型 | 说明 |
|---|---|---|
pro_handle |
Prohandle |
要销毁的进程的进程句柄 |
返回类型
Compcode
完成代码,指示仿真内核是否成功销毁了该进程。可将该返回代码与常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较,以确定进程销毁是否成功。
示例
摘自:示例模型(models/std/x25);外部文件(x25_funcs.ex.c);函数(x25_channel_free())。
/* Extract the group and channel indices from the channel number */
group = (chan_num & X25C_MASK_GROUP) >> X25C_SHIFT_GROUP;
index = (chan_num & X25C_MASK_LCHAN) >> X25C_SHIFT_ICHAN;
if (root [group] != OPC_NIL)
{
/* Get the pointer to the channel. */
chan_ptr = root [group][index];
if (chan_ptr != OPC_NIL)
{
/* Destroy the sub-process. */
if (op_pro_destroy (chan_ptr->process) == OPC_COMPCODE_FAILURE)
{
x25_warning (“Unable to destroy channel process.”);
}
/* Deallocate the memory for the channel structure. */
/* First the string pointers. */
op_prg_mem_free (chan_ptr->local_addr);
op_prg_mem_free (chan_ptr->remote_addr);
op_prg_mem_free (chan_ptr->loc_app_name);
op_prg_mem_free (chan_ptr->rem_app_name);
/* Deallocate the channel itself. */
op_prg_mem_free (chan_ptr);
/* Mark the entry as free, so that a future connection */
/* can use this channel. */
root [group] [index] = OPC_NIL;
}
}
详情
该内核过程允许一个进程销毁由同一模块拥有的任何其他动态进程(因此,根进程是给定模块中唯一不能被销毁的进程)。(动态进程是指通过内核过程 op_pro_create() 创建的进程;动态进程可以在仿真期间的任何时刻从模型中移除。)
进程的正常终止通常包括释放该进程可能已分配的动态内存,但也可能包括建模应用特有的操作(例如报告该进程历史期间累积的某个统计量的值)。进程模型有一个专门的逻辑部分,用于处理其被销毁时发生的处理。这一部分就是进程模型的终止块(Termination Block),其中的代码在进程被销毁时由仿真内核直接调用。状态变量和临时变量可以在这一部分代码中使用。
进程可以销毁自身,此时它不会返回。因此,进程在销毁自身之后不会执行任何操作,终止块中指定的操作除外。
注意: 内核对父子内存或参数内存的释放不承担任何责任。
用途
支持动态创建进程的移除与释放。这使得处理器或队列能够只保持那些对其正确运行所必需的进程处于活动状态。
错误
- 程序中止:内核过程要求进程上下文。
- 程序中止:段错误。(由于进程句柄格式错误)
- 可恢复错误:进程句柄无效。
- 可恢复错误:进程句柄指向已被销毁的进程(
<proc_id>)。 - 可恢复错误:进程句柄指向远端进程(
<proc_id>)。 - 可恢复错误:进程句柄指向根进程(
<proc_id>)。 - 可恢复错误:进程句柄指向活动进程(
<proc_id>)。
参考
- 使用内核过程 op_pro_destroy_options() 销毁一个进程及为该进程调度的所有未完成事件
- 使用内核过程 op_pro_create() 创建新进程并获取其句柄
- 使用内核过程 op_prg_mem_free() 释放通过 op_prg_mem_alloc() 分配的内存
- 使用内核过程 op_pro_invoke() 调用一个进程
- 使用内核过程 op_pro_parmem_access() 获取已安装的父子共享内存的地址