EVT_PACKET_QUEUE_STOP回调函数（netpacketqueue.h）

项目
02/07/2025

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 数据路径轮询模型的关系图，请参阅传输和接收队列。