op_strm_flush()
摘要
清空指定的输入数据包流,销毁其中包含的所有数据包。
语法
op_strm_flush (instrm_index)
| 参数 | 类型 | 说明 |
|---|---|---|
instrm_index |
int |
目标输入流的数字索引 [输入流索引从 0 开始,依次递增 1。若为此参数指定常量 OPC_STRM_ALL,则清空该模块的所有输入流。] |
返回类型
void
无返回值。
示例
/** loop through all input streams, flushing those that have more **/
/** than one packet queued up within them **/
/* determine the number of allocated input streams */
alloc_instrms = op_strm_max_index_in ();
/* loop through each allocated stream */
for (i = 0; i <= alloc_outstrms; i++)
{
/* if an input stream contains more than one packet, drain it completely. */
if (op_strm_pksize (i) > 1)
op_strm_flush (i);
}
详情
输入流最初为空。数据包通过两种技术放入输入流:
- 已连接的输入流接收通过
op_pk_send…()系列内核过程传输的数据包,其源模块通过物理数据包流与之相连。 - 未连接的输入流只能接收通过
op_pk_deliver…()系列内核过程传输的数据包,其源处理器或队列甚至不必与目标模块位于同一节点中。
从输入流中移除数据包同样有两种技术:
- 数据包可以使用内核过程 op_pk_get() 逐个移除,然后由过程算法加以处理。
- 当数据包不再有用时,可以使用
op_strm_flush()将其成批地破坏性移除。
可以指定逻辑流索引 OPC_STRM_ALL,使所有现存的输入流都被清空。
用途
提供一种移除输入流中所有数据包的机制。数据包在此过程中被销毁,因此该操作仅用于由于某种动态条件可以丢弃输入流中数据包的场合。清空输入流的典型用途包括:模拟节点崩溃或重启、链路或链路接口下线、使当前缓存数据失效的路由或其他网络管理更新,以及关闭无需投递当前缓存消息的虚电路或会话。
错误
- 程序中止:内核过程需要过程上下文。
- 程序中止:分配(
<n>个)输入流失败。 - 可恢复错误:输入流索引(
<strm_index>)超出范围。
参考
- 使用内核过程 op_strm_empty() 判定输入流是否为空
- 使用内核过程 op_strm_pksize() 确定输入流中排队的数据包数量
- 使用内核过程 op_pk_get() 从输入流中移除第一个数据包并获得指向它的指针