Funzione NetTxQueueCreate (nettxqueue.h)

Articolo
05/23/2024

Crea un oggetto coda di trasmissione net.

Sintassi

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

Parametri

[_Inout_] NetTxQueueInit

Puntatore alla struttura NETTXQUEUE_INIT ricevuta dal driver client in EVT_NET_ADAPTER_CREATE_TXQUEUE.

[_In_opt_] TxQueueAttributes

Puntatore a una struttura di WDF_OBJECT_ATTRIBUTES allocata dal chiamante inizializzato. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES. Tuttavia, se il driver client fornisce questo parametro, il campo ParentObject deve essere NULL.

[_In_] Configuration

Puntatore a una struttura NET_PACKET_QUEUE_CONFIG allocata dal chiamante.

[_Out_] PacketQueue

Puntatore a una posizione che riceve un handle per il nuovo oggetto coda di trasmissione net.

Valore restituito

La funzione restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione può restituire un codice di errore NTSTATUS appropriato.

Commenti

Il client chiama NetTxQueueCreate dall'interno della relativa funzione di callback degli eventi EVT_NET_ADAPTER_CREATE_TXQUEUE . Per informazioni sull'assegnazione dello spazio di contesto al nuovo oggetto, vedere Framework Object Context Space.

L'oggetto NETPACKETQUEUE è un oggetto WDF standard. Il framework gestisce l'eliminazione, che si verifica quando l'oggetto NETADAPTER padre viene eliminato.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.27
Versione UMDF minima	2.33
Intestazione	nettxqueue.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Condividi tramite