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

Функция NetTxQueueCreate (nettxqueue.h)

  • Статья

Создает объект очереди чистой передачи.

Синтаксис

NTSTATUS NetTxQueueCreate(
  [_Inout_]  NETTXQUEUE_INIT         *NetTxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *TxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Параметры

[_Inout_] NetTxQueueInit

Указатель на структуру NETTXQUEUE_INIT , полученную драйвером клиента в EVT_NET_ADAPTER_CREATE_TXQUEUE.

[_In_opt_] TxQueueAttributes

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

[_In_] Configuration

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

[_Out_] PacketQueue

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

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

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

Комментарии

Клиент вызывает NetTxQueueCreate из функции обратного вызова события EVT_NET_ADAPTER_CREATE_TXQUEUE . Сведения о назначении контекстного пространства новому объекту см. в разделе Пространство контекста объекта платформы.

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

Требования

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