op_intrpt_schedule_self_mt()
摘要
安排一个由客户端明确保证可安全并行执行的自中断。
语法
op_intrpt_schedule_self_mt (time, code)
| 参数 | 类型 | 说明 |
|---|---|---|
time |
double |
中断的安排时间 [该值是绝对仿真时间,而不是相对于当前仿真时间的延迟。如果“sim_time_quantum“首选项的值不为 0.0,time 将在内部被截断为指定量子(quantum)的整数倍。] |
code |
int |
与中断关联的用户定义数字代码 [该值是任意的、用户定义的整数,可用作所安排中断的识别代码;当中断调用进程时,可使用内核过程 op_intrpt_code() 获取该代码。你可以为其指定一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。] |
返回类型
Evhandle
所安排中断的事件句柄。
[该返回值可以存储在状态变量中,以便在后续调用 op_ev_cancel() 时用于识别该中断。]
示例
/* get a handle on packet at head of subqueue 0 */
/* (this does not remove the packet) */
pkptr = op_subq_pk_access (0, OPC_QPOS_HEAD);
/* determine the packet’s length (in bits) */
pk_len = op_pk_total_size_get (pkptr);
/* determine the time required to complete */
/* service of the packet */
pk_svc_time = pk_len / service_rate;
/* schedule an interrupt for this process */
/* for the time when service ends. */
op_intrpt_schedule_self_mt (op_sim_time () + pk_svc_time, 0);
/* the server is now busy. */
server_busy = 1;
详情
与 op_intrpt_schedule_self() 相同,不同之处在于允许并行执行,而不考虑模块的 MT 安全规则。
用途
提供了一种机制,用于安排一个在使用并行内核时将被考虑用于并行执行的自中断。通过使用这一内核过程,你保证该中断事件是 MT 安全的;因此,它将被安排并行执行,而无需评估当前模块通常的 MT 安全规则。在串行内核中,该内核过程的行为与 op_intrpt_schedule_self() 完全相同。
错误
- 程序中止:内存分配失败。
- 程序中止:该内核过程需要进程上下文。(如果从处理器或队列之外调用)
- 可恢复错误:指定时间 (
<time>) 小于当前时间。 - 可恢复错误:指定时间 (
<time>) 是无效的双精度值。
参考
- 使用内核过程 op_intrpt_schedule_remote() 安排远程中断
- 使用内核过程 op_intrpt_force_remote() 强制远程中断
- 使用内核过程 op_intrpt_schedule_call() 安排过程中断
- 使用内核过程 op_ev_cancel() 取消待处理的自中断、远程中断或过程中断
- 使用内核过程 op_intrpt_code() 获取与传入中断关联的代码