NetRxQueueCreate-Funktion (netrxqueue.h)

Artikel
05/23/2024

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

[_In_opt_] RxQueueAttributes

Ein Zeiger auf die vom Aufrufer zugewiesene und initialisierte 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 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.

Hinweise

Der Client ruft NetRxQueueCreate aus seiner EVT_NET_ADAPTER_CREATE_RXQUEUE 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	netrxqueue.h (include netadaptercx.h)
Bibliothek	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Freigeben über