Функция NetRxQueueCreate (netrxqueue.h)

Статья
02/07/2025

Создает объект очереди получения сети.

Синтаксис

NTSTATUS NetRxQueueCreate(
  [_Inout_]  NETRXQUEUE_INIT         *NetRxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Параметры

[_Inout_] NetRxQueueInit

Указатель на структуру NETRXQUEUE_INIT, полученную драйвером клиента в функции обратного вызова EVT_NET_ADAPTER_CREATE_RXQUEUE.

[_In_opt_] RxQueueAttributes

Указатель на выделенную и инициализированную WDF_OBJECT_ATTRIBUTES структуру. Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES. Однако если драйвер клиента предоставляет этот параметр, поле ParentObject должно быть NULL.

[_In_] Configuration

Указатель на структуру, выделенную вызывающим объектом NET_PACKET_QUEUE_CONFIG.

[_Out_] PacketQueue

Указатель на расположение, которое получает дескриптор к новому объекту очереди получения сети.

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

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

Замечания

Клиент вызывает NetRxQueueCreate из функции обратного вызова событий EVT_NET_ADAPTER_CREATE_RXQUEUE. Сведения о назначении пространства контекста новому объекту см. в пространстве контекста объекта Framework.

Объект NETPACKETQUEUE является стандартным объектом WDF. Платформа управляет его удалением, которое происходит при удалении родительского объекта NETADAPTER.

Требования

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

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