op_pk_send_quiet()
摘要
将指定数据包通过输出数据包流转发(不安排中断,也不调用目标模块上运行的进程),随后释放对该数据包的拥有权。
语法
op_pk_send_quiet (pkptr, outstrm_index)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
outstrm_index |
int |
外围模块的一个输出数据包流的索引 |
返回类型
void
无返回值。
示例
摘自:示例模型(models/std/base);进程模型(pc_lifo);状态(SEND_HEAD);进入执行语句。
/* a request has been made to access the queue */
/* check if its empty */
if (!op_subq_empty (0))
{
/* access the first packet in the subqueue */
pkptr = op_subq_pk_remove (0, OPC_QPOS_HEAD);
/* forward it to the destination */
/* without causing a stream interrupt */
op_pk_send_quiet (pkptr, 0);
}
详情
该内核过程将指定数据包转发到目标模块,没有任何延迟或安排。数据包到达不被安排,因此仿真事件列表不参与这一操作。由于数据包到达不会向目标模块递交中断,故称之为"静默"。因此,目标模块进程负责在其将来被其他中断调用的某个时刻,检测被转发的数据包在输入流中的存在。在同一次进程调用期间可以向同一目标模块发送多个数据包,因为目标模块的输入流会缓冲传入的数据包。当目标进程下次被调用时,它可以使用 op_strm_empty() 或 op_strm_pksize() 检测已静默到达其输入流的数据包。如果流中存在数据包,可以使用 op_pk_get() 获取它们。
数据包一旦传递给该内核过程,调用进程即失去对该数据包的拥有权,拥有权转移给目标模块。发送进程再以任何内核过程传入这个"过期"的数据包指针,都会导致数据包拥有权错误。
该内核过程要求进程上下文,因此只能从进程模型、或由进程模型直接或间接调用的函数中调用。该内核过程可传输非格式化与格式化数据包。
用途
提供一种在单个节点内通过数据包流相连的模块之间传输数据包的机制。该内核过程是 op_pk_send() 的一个变体,适用于目标模块不应被数据包到达打断的情形,通常是因为它在使用内核过程 op_strm_access() 之后已经在等待接收数据包。op_pk_send() 的其他变体可在目标模块产生强制或延迟到达;而另一组 op_pk_deliver…() 内核过程则提供不需要物理流对象存在的数据包传输。
op_pk_send_quiet() 允许将数据包转发到处理器或队列中运行的其他进程,或转发到为节点间通信链路提供接口的发射机模块。
错误
- 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针引用已被销毁的数据包。
- 程序中止:数据包指针引用无主数据包(
<pk_id>)。 - 程序中止:数据包指针引用静态数据包(
<pk_id>)。 - 程序中止:数据包投递在对象(
<mod_objid>)、流(<instrm_index>)处失败。 - 程序中止:内核过程要求进程上下文。
- 可恢复错误:输出流索引(
<outstrm_index>)超出范围。 - 可恢复错误:输出流索引(
<outstrm_index>)未被占用。
参考
- 使用 op_pk_send() 通过常规事件安排方式发送数据包
- 使用 op_pk_send_delayed() 发送延迟到达的数据包
- 使用 op_pk_send_forced() 发送数据包并在目标处立即开始处理
- 使用
op_pk_deliver…()在不使用数据包流的情况下将数据包转发到其他模块 - 使用 op_strm_empty() 或 op_strm_pksize() 检测输入流中是否含有数据包
- 使用 op_pk_get() 获取到达数据包的指针