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

Статья
02/07/2025

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

Синтаксис

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. Сведения о назначении пространства контекста новому объекту см. в пространстве контекста объекта Framework.

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

Требования

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

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