NetTxQueueCreate-Funktion (nettxqueue.h)

Erstellt ein Netzübertragungswarteschlangenobjekt.

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_TXQUEUEempfangen hat.

[_In_opt_] TxQueueAttributes

Ein Zeiger auf eine initialisierte, aufrufergeteilte WDF_OBJECT_ATTRIBUTES Struktur. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTESwerden. Wenn jedoch der Clienttreiber diesen Parameter bereitstellt, muss das ParentObject Feld NULL-sein.

[_In_] Configuration

Ein Zeiger auf eine vom Aufrufer zugewiesene NET_PACKET_QUEUE_CONFIG Struktur.

[_Out_] PacketQueue

Ein Zeiger auf eine Position, die ein Handle für das neue Net Transmit Queue-Objekt 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.

Bemerkungen

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

Das NETPACKETQUEUE-Objekt ist ein WDF-Standardobjekt. Das Framework verwaltet den Löschvorgang, der auftritt, wenn das übergeordnete NETADAPTER-Objekt gelöscht wird.

Anforderungen