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>) 是无效的双精度值。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com