op_intrpt_schedule_process()
摘要
在指定的时间为特定进程安排一个进程中断。
语法
op_intrpt_schedule_process (pro_handle, time, code)
| 参数 | 类型 | 说明 |
|---|---|---|
pro_handle |
Prohandle |
将在指定时间接收中断的进程的句柄。 [Pro 包中的多个内核过程可用于获取进程句柄,包括 op_pro_self()、op_pro_parent() 和 op_pro_root()。] |
time |
double |
中断的安排时间 [该值是绝对仿真时间,而不是相对于当前仿真时间的延迟。如果“sim_time_quantum“首选项的值不为 0.0,time 将在内部被截断为指定量子(quantum)的整数倍。] |
code |
int |
将与中断关联并经由内核过程 op_intrpt_code() 提供给目标进程的整数值。该值的含义由用户定义,通常用于区分模型化系统中进程中断的各种可能起因。 你可以为其指定一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。 |
返回类型
Evhandle
所安排中断的事件句柄。
[该返回值可以存储在状态变量中,以便在后续调用 op_ev_cancel() 时用于识别该中断。]
示例
摘自:示例模型(models/std/x25);进程模型(x25_dce_chan);状态(p6):
else
{
/* We came here normally because of a CLEAR REQUEST packet. */
/* Reset the channel. */
x25_dce_channel_reset ();
/* Send a confirmation packet to the DTE. */
x25_pk_send_local (chan_vars->data_link, chan_vars->number, x25_GFI_BASE,
X25C_PT_CLEAR_CONFIRM);
/* Send a CLEAR INDICATION to the remote end. */
x25_dce_pk_send_remote (OSIC_N_DISCONNECT_INDICATION, pkptr);
/* Notify our root process that we can be deleted. The deletion will take */
/* place after the current invocation of this process completes. */
op_intrpt_schedule_process (op_pro_parent (op_pro_self ()), op_sim_time(),
chan_vars->number);
}
详情
与其他以特定进程为目标的事件类型(如自中断)一样,进程中断的执行也可能发生在该进程已被销毁之后。这会在所安排的中断时间产生一条诊断错误,且中断不会被传送。对于这种情况,建议(在可能时)使用 op_intrpt_schedule_process() 返回的事件句柄,在目标进程被销毁时取消该事件。
也可以使用这个内核过程为当前进程安排事件,其用法与 op_intrpt_schedule_self() 类似。
如果发生可恢复错误(参见错误一节),该内核过程将返回一个无效的事件句柄。这一状况可以通过调用内核过程 op_ev_valid() 来检测。
如上所述,有时由于条件变化而需要取消进程中断。取消中断要求把该内核过程返回的事件句柄存储在状态变量中,并在稍后传递给内核过程 op_ev_cancel(),如下例所示:
/* state variable declaration */
Evhandle \evh;
/* process interrupt scheduling */
evh = op_intrpt_schedule_process (proch, 5.0, AL_CODE);
/* process interrupt cancelling */
op_ev_cancel (evh);
用途
提供了以延迟方式调用进程的能力,这与 op_pro_invoke() 形成对照——后者允许调用进程,但只能立即调用。此外,op_intrpt_schedule_process() 支持调用当前模块之外的进程,而 op_pro_invoke() 不支持。
进程在协作完成单一任务时通常需要相互调用。例如释放某个资源或通知任务完成;虽然远程中断也能支持这类活动,但该内核过程提供了额外的能力,可以中断特定进程而非整个模块。这样就避免了打断目标模块中的其他进程并让它们充当中间人。
错误
- 程序中止:该内核过程需要进程上下文。
- 程序中止:段违例。(由格式错误的进程句柄导致。)
- 可恢复错误:进程句柄无效。
- 可恢复错误:进程句柄属于已销毁的进程 (
<proc_id>)。 - 可恢复错误:指定时间 (
<time>) 小于当前时间。 - 可恢复错误:指定时间 (
<time>) 是无效的双精度值。
参考
- 使用内核过程 op_intrpt_schedule_self() 安排自中断
- 使用内核过程 op_intrpt_schedule_remote() 安排远程中断
- 使用内核过程 op_ev_cancel() 取消待处理的中断
- 使用内核过程 op_pro_parent()、op_pro_self() 和 op_pro_root() 获取进程句柄。