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

  • Статья

Реализация драйвером клиента функции обратного вызова события 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(status) равно TRUE. В противном случае — соответствующий код ошибки NTSTATUS .

Комментарии

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

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

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

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

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

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1.29
Верхняя часть netadapter.h (включая netadaptercx.h)
IRQL PASSIVE_LEVEL