функция обратного вызова 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 после инициализации структуры NET_PACKET_QUEUE_CONFIG_INIT, а затем вызовите NetTx(rxQueueContext)QueueCreate.

Этот обратный вызов не возвращает значение и поэтому не должен завершать ошибку, поэтому этот обратный вызов должен быть функцией легкого веса, которая выполняется быстро.

Клиентские драйверы не будут получать вызовы EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCELили EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED после возврата EvtPacketQueueS top. Кроме того, EvtPacketQueueStop вызывается в том же контексте выполнения или потоке, как EvtPacketQueueAdvance, EvtPacketQueueCancelи EvtPacketQueueSetNotificationEnabled, поэтому клиентские драйверы не должны синхронизироваться между этими функциями обратного вызова для отдельного экземпляра очереди.

Дополнительные сведения и схема с моделью опроса пути данных NetAdapterCx см. в разделе Очереди передачи и получения.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.27
минимальная версия UMDF	2.33
заголовка	netpacketqueue.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL