функция обратного вызова EVT_NET_ADAPTER_CREATE_TXQUEUE (netadapter.h)

Статья
02/07/2025

Реализация драйвера клиента функции обратного вызова события EvtNetAdapterCreateTxQueue функции обратного вызова событий, которая настраивает очередь передачи (Tx).

Синтаксис

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

Параметры

[_In_] Adapter

Объект сетевого адаптера, созданный клиентом перед вызовом NetAdapterCreate.

[_Inout_] TxQueueInit

Указатель на выделенную NETTXQUEUE_INIT структуру NetAdapterCx. Дополнительные сведения см. в разделе "Примечания".

Возвращаемое значение

Если операция выполнена успешно, функция обратного вызова должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(состояние) равно TRUE. В противном случае соответствующий код ошибки NTSTATUS.

Замечания

Чтобы зарегистрировать функцию обратного вызова EVT_NET_ADAPTER_CREATE_TXQUEUE, драйвер клиента должен вызвать NetAdapterCreate.

Структура NETTXQUEUE_INIT — это непрозрачная структура, определяемая и выделенная NetAdapterCx, аналогичная WDFDEVICE_INIT.

В этом обратном вызове драйвер клиента может вызвать NetTxQueueInitGetQueueId для получения идентификатора очереди передачи для настройки. Затем клиент вызывает NetTxQueueCreate для выделения очереди. Если netTxQueueCreate завершается ошибкой, функция обратного вызова EvtNetAdapterCreateTxQueue должна возвращать код ошибки.

NetAdapterCx вызывает EvtNetAdapterCreateTxQueue в самом конце последовательности питания.

Пример кода реализации этой функции обратного вызова см. в очереди передачи и получения.

Требования

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

Поделиться через