op_apptrack_rx_processing_disable()
摘要
禁用接收机或接收信道中对接收事件的系统性记录。
语法
op_apptrack_rx_processing_disable (rx_objid)
| 参数 | 类型 | 说明 |
|---|---|---|
rx_objid |
Objid |
所关注的接收机或接收信道(可为点对点、总线或无线)。 |
返回类型
Compcode
若该内核过程成功完成则返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
详情
给定 rx_objid 下的所有接收信道都会被禁用。可以将 OPC_OBJID_UNIVERSAL 作为 rx_objid 传入,以禁用网络中所有接收信道(点对点、总线与无线)。
用途
该内核过程禁用接收机或接收信道对已打标记数据包的默认处理(例如接收时间的记录)。它通常用于由更高层决定给定数据包是否在给定接收节点被接受的场合;当某个数据包可能被发往多个目的端(广播介质)而实际接收者只有一个接收机时尤其有用。此时预期的接收机可以调用 op_apptrack_rx_record() 来处理该数据包。
错误
- 可恢复错误:对象 ID (
<rx_objid>) 超出范围。 - 可恢复错误:对象 ID (
<rx_objid>) 指向受限对象。 - 可恢复错误:对象 (
<rx_objid>) 类型不正确 (<rx_obj_type>);应为接收机或接收信道对象。
参考
- 使用内核过程 op_apptrack_rx_record() 在合适的时机记录数据包接收。