NetRxQueueCreate-Funktion (netrxqueue.h)

  • Artikel

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
Kopfzeile netrxqueue.h (include netadaptercx.h)
Bibliothek NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL