EVT_NET_ADAPTER_CREATE_TXQUEUE Rückruffunktion (netadapter.h)

Artikel
05/23/2024

Die Implementierung der Ereignisrückruffunktion EvtNetAdapterCreateTxQueue durch den Clienttreiber, die eine Übertragungswarteschlange (Tx) einrichtet.

Syntax

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

Parameter

[_In_] Adapter

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

[_Inout_] TxQueueInit

Ein Zeiger auf eine netAdapterCx-zugeordnete NETTXQUEUE_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) true entspricht. Andernfalls ein entsprechender NTSTATUS-Fehlercode .

Hinweise

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

Die NETTXQUEUE_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 NetTxQueueInitGetQueueId auf, um den Bezeichner der einzurichtenden Übertragungswarteschlange abzurufen. Als Nächstes ruft der Client NetTxQueueCreate auf , um eine Warteschlange zuzuweisen. Wenn NetTxQueueCreate fehlschlägt, sollte die Rückruffunktion EvtNetAdapterCreateTxQueue einen Fehlercode zurückgeben.

NetAdapterCx ruft EvtNetAdapterCreateTxQueue 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