Función NetTxQueueCreate (nettxqueue.h)

Crea un objeto de cola de transmisión neta.

Sintaxis

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

Parámetros

[_Inout_] NetTxQueueInit

Puntero a la estructura de NETTXQUEUE_INIT que el controlador de cliente recibió en EVT_NET_ADAPTER_CREATE_TXQUEUE.

[_In_opt_] TxQueueAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada inicializada. Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES. Sin embargo, si el controlador de cliente proporciona este parámetro, el campo ParentObject debe ser NULL.

[_In_] Configuration

Puntero a una estructura de NET_PACKET_QUEUE_CONFIG asignada por el autor de la llamada.

[_Out_] PacketQueue

Puntero a una ubicación que recibe un identificador para el nuevo objeto de cola de transmisión neta.

Valor devuelto

La función devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función puede devolver un código de error NTSTATUS adecuado.

Comentarios

El cliente llama a NetTxQueueCreate desde su EVT_NET_ADAPTER_CREATE_TXQUEUE función de devolución de llamada de eventos. Para obtener información sobre cómo asignar espacio de contexto al nuevo objeto, vea Espacio de contexto de objetos de marco.

El objeto NETPACKETQUEUE es un objeto WDF estándar. El marco administra su eliminación, que se produce cuando se elimina el objeto PRIMARIO NETADAPTER.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.27
Encabezado	nettxqueue.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL