NetRxQueueCreate-Funktion (netrxqueue.h)

Erstellt ein Net Receive Queue -Objekt.

Syntax

NTSTATUS NetRxQueueCreate(
  [_Inout_]  NETRXQUEUE_INIT         *NetRxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Parameter

[_Inout_] NetRxQueueInit

Ein Zeiger auf die NETRXQUEUE_INIT Struktur, die der Clienttreiber in seiner EVT_NET_ADAPTER_CREATE_RXQUEUE Rückruffunktion erhalten hat.

[_In_opt_] RxQueueAttributes

Ein Zeiger zum aufrufenden zugewiesenen und initialisierten 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 Receive Queue-Objekt empfängt.

Rückgabewert

Diese 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 NetRxQueueCreate innerhalb der EVT_NET_ADAPTER_CREATE_RXQUEUE 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

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.27
Mindest-UMDF-Version	2.33
Header-	netrxqueue.h (include netadaptercx.h)
Library	NetAdapterCxStub.lib
IRQL-	PASSIVE_LEVEL