EVT_NET_ADAPTER_CREATE_RXQUEUE Rückruffunktion (netadapter.h)

Artikel
05/23/2024

Die Implementierung des Clienttreibers der Ereignisrückruffunktion EvtNetAdapterCreateRxQueue , die eine Empfangswarteschlange (Rx) einrichtet.

Syntax

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}

Parameter

[_In_] Adapter

Das Netzwerkadapterobjekt, das der Client vor einem Aufruf von NetAdapterCreate erstellt hat.

[_Inout_] RxQueueInit

Ein Zeiger auf eine netAdapterCx-zugeordnete NETRXQUEUE_INIT-Struktur . Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS oder einen anderen status Wert zurückgeben, für den NT_SUCCESS(status) gleich TRUE ist. Andernfalls ein geeigneter NTSTATUS-Fehlercode .

Hinweise

Um eine EVT_NET_ADAPTER_CREATE_RXQUEUE Rückruffunktion zu registrieren, muss der Clienttreiber NetAdapterCreate aufrufen.

Die NETRXQUEUE_INIT-Struktur ist eine undurchsichtige Struktur, die von NetAdapterCx definiert und zugeordnet wird, ähnlich wie WDFDEVICE_INIT.

In diesem Rückruf ruft der Clienttreiber möglicherweise NetRxQueueInitGetQueueId auf, um den Bezeichner der einzurichtenden Empfangswarteschlange abzurufen. Als Nächstes ruft der Client NetRxQueueCreate auf , um eine Warteschlange zuzuordnen. Wenn NetRxQueueCreate fehlschlägt, sollte die Rückruffunktion EvtNetAdapterCreateRxQueue einen Fehlercode zurückgeben.

NetAdapterCx ruft EvtNetAdapterCreateRxQueue ganz am Ende der Einschaltsequenz auf.

Ein Codebeispiel für die Implementierung dieser Rückruffunktion finden Sie unter Übertragen und Empfangen von Warteschlangen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.29
UMDF-Mindestversion	2.33
Kopfzeile	netadapter.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Freigeben über