EVT_NET_ADAPTER_CREATE_TXQUEUE Rückruffunktion (netadapter.h)

Die Implementierung des Clienttreibers der EvtNetAdapterCreateTxQueue Ereignisrückruffunktion, 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 NetAdapterCreateerstellt hat.

[_Inout_] TxQueueInit

Ein Zeiger auf eine netAdapterCx-zugeordnete NETTXQUEUE_INIT Struktur. Weitere Informationen finden Sie im Abschnitt "Hinweise".

Rückgabewert

Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) WAHR ist. Andernfalls NTSTATUS Fehlercode.

Bemerkungen

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

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

NetAdapterCx ruft EvtNetAdapterCreateTxQueue am Ende der Power-Up-Sequenzauf.

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

Anforderungen