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

Статья
02/07/2025

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

Синтаксис

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}

Параметры

[_In_] Adapter

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

[_Inout_] RxQueueInit

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

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

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

Замечания

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

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

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

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

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

Требования

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

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