op_pk_deliver_delayed()
摘要
将指定数据包转发到远程模块,将数据包到达该模块的时间调度到延迟后的仿真时间,并释放调用进程对该数据包的拥有权。
语法
op_pk_deliver_delayed (pkptr, mod_objid, instrm_index, delay)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
mod_objid |
Objid |
远程模块的对象 ID [模块对象 ID 可以从 Topo 和 Id 包中的若干内核过程获得: op_id_self()、op_topo_child() 和 op_id_from_name()。] |
instrm_index |
int |
远程模块某个输入数据包流的索引 |
delay |
double |
延迟数据包到达的仿真时间量 [必须为正数(或零)。] |
返回类型
void
无返回值。
示例
/* obtain the object ID of remote telemetry processor */
node_objid = op_id_from_name (0, OPC_OBJTYPE_NODE_FIXED, "tlm_node");
proc_objid = op_id_from_name (node_objid, OPC_OBJTYPE_PROC, "tlm_proc");
/* create a packet */
length = (int) op_dist_uniform (MAX_PK_SIZE);
pkptr = op_pk_create (length);
/* stuff packet with operation code */
op_pk_fd_set (pkptr, 0, OPC_FIELD_TYPE_INTEGER, OPCODE_DOWNLOAD, 16);
/* deliver the packet to remote processor with a delay */
com_delay = length / 300.0;
op_pk_deliver_delayed (pkptr, proc_objid, 0, com_delay);
详情
该内核过程将指定数据包到达指定远程模块的时间进行调度。到达时间被调度为当前仿真时间加上指定的延迟,相应的事件被加入仿真事件列表。事件一经调度,该内核过程立即将控制权返回给调用进程。该事件将在延迟后的仿真时间发生,但不会先于已调度到同一仿真时间的其他事件执行。在延迟间隔内,调用进程可以自由进行任何活动;它与被延迟的数据包不再有任何关联。因此该内核过程可用于模拟多处理服务器的处理延迟;单处理场景可能需要通过自调度中断来限制在延迟间隔内对数据包的进一步处理。当调度的事件执行时,远程模块将以流中断方式被调用。如果远程模块是处理器或队列,其关联的进程可以通过内核过程 op_intrpt_type() 判断该中断是由输入流引起的。到达输入数据包流的数据包可由目标进程通过内核过程 op_pk_get() 获取。
数据包一旦传递给该内核过程,调用进程即失去对该数据包的拥有权,因为拥有权已转移给远程模块。传递方进程再调用任何内核过程时若传入这个“失效”的数据包指针,将导致数据包拥有权错误。未格式化和已格式化的数据包都可以通过该内核过程传递。
用途
提供一种不依赖数据包流、在模块之间传递数据包的机制。使用该内核过程传递数据包是面向数据包流的 op_pk_send…() 系列内核过程的替代方式。该内核过程是基本操作 op_pk_deliver() 的一个变体,适用于模拟由调用进程引起的处理或传输延迟。op_pk_deliver() 的其他变体提供在远程模块的强制到达或静默到达。数据包可以交付到处理器或队列中运行的其他进程,或交付到发射机模块。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<pk_id>)。 - 程序中止:数据包指针指向静态数据包 (
<pk_id>)。 - 程序中止:数据包交付失败,对象 (
<mod_objid>),流 (<instrm_index>)。 - 可恢复错误:延迟值 (
<delay>) 超出范围。 - 可恢复错误:对象 ID (
<mod_objid>) 超出范围。
参考
- 使用内核过程 op_pk_deliver() 无延迟地交付数据包
- 使用内核过程 op_pk_deliver_forced() 交付数据包以便在远程模块立即处理
- 使用内核过程 op_pk_deliver_quiet() 交付数据包且不在远程模块引起中断
- 使用
op_pk_send…()内核过程通过数据包流向相邻模块转发包 - 使用内核过程 op_pk_get() 获取到达数据包的指针