op_pro_destroy_options()
摘要
销毁一个动态创建的进程,并(可选地)销毁为该进程调度的所有未完成事件。
语法
op_pro_destroy_options (pro_handle, options)
| 参数 | 类型 | 说明 |
|---|---|---|
pro_handle |
Prohandle |
要销毁的进程的进程句柄 |
options |
int |
要执行的可选操作(参见详情)。 |
返回类型
Compcode
完成代码,指示仿真内核是否成功销毁了该进程。可将该返回代码与常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较,以确定进程销毁是否成功。
示例
/* Destroy this process and clear process' outstanding events */
op_pro_destroy_options (op_pro_self(), OPC_PRO_DESTROY_OPT_NONE);
详情
该内核过程允许一个进程销毁由同一模块拥有的任何其他动态进程(因此,根进程是给定模块中唯一不能被销毁的进程)。此外,op_pro_destroy_options() 还可选地移除为被销毁进程调度的所有未完成事件。(动态进程是指通过内核过程 op_pro_create() 创建的进程;动态进程可以在仿真期间的任何时刻从模型中移除。)
进程的正常终止通常包括释放该进程可能已分配的动态内存,但也可能包括建模应用特有的操作(例如报告该进程历史期间累积的某个统计量的值)。进程模型有一个专门的逻辑部分,用于处理其被销毁时发生的处理。这一部分就是进程模型的终止块(Termination Block),其中的代码在进程被销毁时由仿真内核直接调用。状态变量和临时变量可以在这一部分代码中使用。
进程可以销毁自身,此时它不会返回。因此,进程在销毁自身之后不会执行任何操作,终止块中指定的操作除外。
注意: 内核对父子内存或参数内存的释放不承担任何责任。
该内核过程可用的选项如下:
OPC_PRO_DESTROY_OPT_KEEP_EVENTS—— 该内核过程不移除为被销毁进程调度的任何未完成事件(因此,使用此选项的op_pro_destroy_options()与 op_pro_destroy() 的作用完全相同)。OPC_PRO_DESTROY_OPT_NONE—— 默认操作。
用途
支持动态创建进程的移除与释放,并可选地移除为这些进程调度的未完成事件。这使得处理器或队列能够只保持那些对其正确运行所必需的进程处于活动状态。
错误
- 程序中止:内核过程要求进程上下文。
- 程序中止:段错误。(由于进程句柄格式错误)
- 可恢复错误:进程句柄无效。
- 可恢复错误:进程句柄指向已被销毁的进程(
<proc_id>)。 - 可恢复错误:进程句柄指向远端进程(
<proc_id>)。 - 可恢复错误:进程句柄指向根进程(
<proc_id>)。 - 可恢复错误:进程句柄指向活动进程(
<proc_id>)。
参考
- 使用内核过程 op_pro_create() 创建新进程并获取其句柄
- 使用内核过程 op_prg_mem_free() 释放通过 op_prg_mem_alloc() 分配的内存
- 使用内核过程 op_pro_invoke() 调用一个进程
- 使用内核过程 op_pro_parmem_access() 获取已安装的父子共享内存的地址