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

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

  • Статья

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

Синтаксис

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 Object Context Space.

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

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1.27
Минимальная версия UMDF 2.33
Верхняя часть netrxqueue.h (включая netadaptercx.h)
Библиотека NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL