op_strm_pksize()
摘要
获取指定输入流中包含的数据包数量。
语法
op_strm_pksize (instrm_index)
| 参数 | 类型 | 说明 |
|---|---|---|
instrm_index |
int |
目标输入流的数字索引 [输入流索引从 0 开始,依次递增 1。] |
返回类型
int
指定输入流中包含的数据包数量。若发生可恢复错误,将返回常量 OPC_INT_INVALID。
示例
/** 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_intstrms; i++)
{
/* if an input stream contains more than one packet, flush it */
if (op_strm_pksize (i) > 1)
op_strm_flush (i);
}
详情
输入流最初为空。数据包通过两种技术放入输入流:
- 已连接的输入流接收通过
op_pk_send…()系列内核过程传输的数据包,其源模块通过物理数据包流与之相连。 - 未连接的输入流只能接收通过
op_pk_deliver…()系列内核过程传输的数据包,其源处理器或队列甚至不必与目标模块位于同一节点中。
从输入流中移除数据包同样有两种技术:
- 数据包可以使用内核过程 op_pk_get() 逐个移除,然后由过程算法加以处理。
- 当数据包不再有用时,可以使用内核过程 op_strm_flush() 将其成批地破坏性移除。
用途
提供一种确定输入流中排队数据包数量的机制。此内核过程通常用于确定一个循环的边界,该循环将依次移除并处理所有数据包。数据包通过内核过程 op_pk_get() 移除。已在模块输入流中排队、但在关联过程的下一次调用期间未被读入和处理的数据包,将继续保持排队状态,直到在后续某次过程调用中被移除。
错误
- 程序中止:内核过程需要过程上下文。
- 程序中止:分配(
<n>个)输入流失败。 - 可恢复错误:输入流索引(
<strm_index>)超出范围。
参考
- 使用内核过程 op_strm_empty() 判定输入流是否为空
- 使用内核过程 op_strm_flush() 移除输入流中的所有数据包
- 使用内核过程 op_pk_get() 从输入流中移除第一个数据包并获得指向它的指针