op_strm_access()
摘要
向连接到指定输入流的模块投递一次访问中断。
语法
op_strm_access (instrm_index)
| 参数 | 类型 | 说明 |
|---|---|---|
instrm_index |
int |
目标输入流的数字索引 [输入流索引从 0 开始,依次递增 1。] |
返回类型
Compcode
完成代码,指示是否在作为指定输入流源的模块处成功生成了访问中断。
示例
/** loop through all input streams, generating an access interrupt for each **/
/* 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 is connected, and... */
if (op_strm_connected (OPC_STRM_IN, i) == OPC_TRUE)
{
/* if an input stream is connected, access a packet from the source module. */
op_strm_access (i);
/* Collect and forward the packet onto the bus, if one was obtained. */
if (op_strm_empty (i) == OPC_FALSE)
op_pk_send (op_pk_get (i), OUTSTRM_BUS);
}
}
详情
从连接到某处理器(或队列)某个输入流的模块访问数据包,主要有两种技术。主动技术(就源模块而言)使用 op_pk_send…() 系列内核过程,在同步或异步时刻自动将数据包发送到目标模块。这种技术不需要目标模块做任何调度,因为数据包到达时该模块会被流中断自动调用。被动技术(就源模块而言)依赖目标模块自行决定何时空闲可以处理数据包,然后中断源模块以获取更多待处理的数据包。中断类型通常是强制的,通过本内核过程创建的访问中断来执行,但也可以使用内核过程 op_intrpt_force_remote() 创建的远程中断。当源模块的过程被中断调用时,它可以确定中断的原因(使用 op_intrpt_strm()),并使用内核过程 op_pk_send_quiet() 向目标转发一个或多个数据包;使用 quiet 模式是为了避免为目标模块调度一个无关的中断,因为该模块已经在等待数据包被转发。
用途
提供一种机制,使连接到指定输入流的模块发生一次访问中断。此能力的设计目的是让主动的服务器处理器能够从运行被动排队过程的队列(如基本模型 pc_fifo 和 pc_lifo)中按需拉取数据包。不过,此内核过程的用途可以扩展到任何处理器或队列想要中断连接到其某个输入流的另一个处理器或队列的场合。
错误
- 可恢复错误:内核过程需要过程上下文。
- 可恢复错误:模块上不存在输入流。
- 可恢复错误:输入流索引(
<instrm_index>)超出范围。 - 可恢复错误:输入流索引(
<instrm_index>)未被占用。 - 可恢复错误:源模块不支持访问中断。
参考
- 使用内核过程 op_strm_empty() 判定输入流是否为空
- 使用内核过程 op_strm_pksize() 确定输入流中排队的数据包数量
- 使用内核过程 op_pk_get() 从输入流中移除第一个数据包并获得指向它的指针