EVT_PACKET_QUEUE_STOP回调函数 (netpacketqueue.h)

项目
05/23/2024

EvtPacketQueueStop 回调函数是一个可选回调，由客户端驱动程序实现，用于停止数据包队列的数据路径。

语法

EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;

void EvtPacketQueueStop(
  [_In_] NETPACKETQUEUE PacketQueue
)
{...}

参数

[_In_] PacketQueue

数据包队列的句柄。

返回值

无

备注

这是一个可选的回调。在 EVT_NET_ADAPTER_CREATE_TX (rxQueueContext) QUEUE 回调中注册此回调函数。使用 NET_PACKET_QUEUE_CONFIG_INIT 初始化结构后，设置 NET_PACKET_QUEUE_CONFIG 结构的相应成员，然后调用 NetTx (rxQueueContext) QueueCreate。

此回调不返回值，因此不应失败，因此此回调应该是可快速执行的轻型函数。

在 EvtPacketQueueStop 返回后，客户端驱动程序不会接收对 EVT_PACKET_QUEUE_ADVANCE、EVT_PACKET_QUEUE_CANCEL 或 EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED 的调用。此外，EvtPacketQueueStop 是在与 EvtPacketQueueAdvance、EvtPacketQueueCancel 和 EvtPacketQueueSetNotificationEnabled 相同的执行上下文或线程中调用的，因此客户端驱动程序不需要在单个队列实例的这些回调函数之间同步。

有关详细信息以及显示 NetAdapterCx 数据路径轮询模型的关系图，请参阅传输和接收队列。