EVT_NET_ADAPTER_CREATE_TXQUEUE Rückruffunktion (netadapter.h)

Die Implementierung des Clienttreibers der Ereignisrückruffunktion EvtNetAdapterCreateTxQueue , 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 vor einem Aufruf von NetAdapterCreate erstellt hat.

[_Inout_] TxQueueInit

Ein Zeiger auf eine mit 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) gleich TRUE ist. Andernfalls ein geeigneter 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
Kopfzeile	netadapter.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL