EVT_PACKET_QUEUE_STOP回调函数 (netpacketqueue.h)

项目
02/29/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 数据路径轮询模型的详细信息和图表，请参阅传输和接收队列。