NetTxQueueCreate-Funktion (nettxqueue.h)

Artikel
05/23/2024

Erstellt ein Net Transmit-Warteschlangenobjekt.

Syntax

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

Parameter

[_Inout_] NetTxQueueInit

Ein Zeiger auf die NETTXQUEUE_INIT Struktur, die der Clienttreiber in EVT_NET_ADAPTER_CREATE_TXQUEUE empfangen hat.

[_In_opt_] TxQueueAttributes

Ein Zeiger auf eine initialisierte, vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES-Struktur . Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden. Wenn der Clienttreiber diesen Parameter jedoch bereitstellt, muss das ParentObject-FeldNULL sein.

[_In_] Configuration

Ein Zeiger auf eine aufruferseitig zugeordnete NET_PACKET_QUEUE_CONFIG-Struktur .

[_Out_] PacketQueue

Ein Zeiger auf einen Speicherort, der ein Handle für das neue Net Transmit-Warteschlangenobjekt empfängt.

Rückgabewert

Die Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.

Hinweise

Der Client ruft NetTxQueueCreate aus seiner EVT_NET_ADAPTER_CREATE_TXQUEUE Ereignisrückruffunktion auf. Informationen zum Zuweisen des Kontextraums zum neuen Objekt finden Sie unter Framework Object Context Space.

Das NETPACKETQUEUE-Objekt ist ein WDF-Standardobjekt. Das Framework verwaltet das Löschen, das beim Löschen des übergeordneten NETADAPTER-Objekts auftritt.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1,27
UMDF-Mindestversion	2.33
Kopfzeile	nettxqueue.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Freigeben über