op_strm_max_index_out()
摘要
获取连接到外围处理器或队列的任意输出流的最大索引。
语法
op_strm_max_index_out ()
| 参数 | 类型 | 说明 |
|---|---|---|
| 无参数 |
返回类型
int
任意已连接输出流的最大索引。由于输出流编号从零开始,若模块没有已连接的输出流,将返回 -1。
示例
/* determine the number of output streams */
num_out_strms = op_strm_max_index_out ();
/* loop through each output stream, dealing out packets in round-robin fashion. */
for (i = 0; i <= num_out_strms; i++)
{
/* Skip the stream if it is not connected. */
if (op_strm_connected (OPC_STRM_OUT, i) == OPC_FALSE)
continue;
/* Obtain a packet from the source buffer. */
op_strm_access (IN_STREAM_SRCBUF);
/* If a packet was made available, forward it to the i_th destination. */
if (op_strm_empty (IN_STREAM_SRCBUF) == OPC_FALSE)
{
pkptr = op_pk_get (IN_STREAM_SRCBUF);
op_pk_send (pkptr, i);
}
}
详情
本内核过程返回的值是所有已连接输出流的最高物理索引(即数据包流对象的 src stream 属性的最大值)。若输出流是稀疏连接的,则返回值与已连接输出流的数量不一定相关。反之,若所有已连接的输出流是连续的,则返回值等于已连接流的数量减一,因为编号从零开始。但无论如何,最大索引(本内核过程返回)加一总是已连接输出流数量的一个上界。
用途
提供一种为连接到其他对象的输出流数量设定上界的机制。当需要对所有已连接输出流执行某项操作、而过程又不具备关于哪些流已连接的内置知识时,这一点很有用。此时,过程可以测试直到并包括本内核过程返回的最大索引的所有输出流,并通过调用内核过程 op_strm_connected() 判定它们是否已连接。
错误
- 程序中止:内核过程需要过程上下文。
参考
- 使用内核过程 op_strm_max_index_in() 确定模块的输入流索引
- 使用内核过程 op_strm_connected() 判定特定的输入或输出流是否已连接