MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion (dot11wdi.h)

Artikel
02/23/2024

Wichtig

Dieses Thema ist Teil des WDI-Treibermodells, das in Windows 10 veröffentlicht wurde. Das WDI-Treibermodell befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität. WiFiCx ist das Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features zu nutzen.

Die MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion informiert die TxEngine darüber, dass die Ziel-TX-Deskriptoren, die den NET_BUFFER_LIST (NBLs) in der NBL-Kette zugeordnet sind, nicht mehr benötigt werden und freigegeben werden können.

Dies ist ein WDI-Miniporthandler in NDIS_MINIPORT_WDI_DATA_HANDLERS.

Hinweis Sie müssen die Funktion mit dem MINIPORT_WDI_TX_TARGET_DESC_DEINIT-Typ deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt Beispiele.

Syntax

MINIPORT_WDI_TX_TARGET_DESC_DEINIT MiniportWdiTxTargetDescDeinit;

void MiniportWdiTxTargetDescDeinit(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] PNET_BUFFER_LIST pNBL
)
{...}

Parameter

[in] MiniportTalTxRxContext

TAL-Gerätehandle, das vom IHV-Miniport in der MINIPORT_WDI_TAL_TXRX_INITIALIZE Rückruffunktion zurückgegeben wird.

[in] pNBL

Zeiger auf eine NET_BUFFER_LIST Kette.

Rückgabewert

Keine

Bemerkungen

Wichtig Der IHV-Miniport darf im Rahmen dieses Aufrufs keine Angaben machen. Der TxMgr serialisiert Aufrufe von TxTargetDescDeInitHandler.

Beispiele

Um eine MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der zu definierenden Funktion identifiziert. Windows stellt eine Reihe von Funktionstypen für Treiber bereit. Das Deklarieren einer Funktion mithilfe der Funktionstypen hilft der Codeanalyse für Treiber, der statischen Treiberüberprüfung (Static Driver Verifier , SDV) und anderen Überprüfungstools, Fehler zu finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion mit dem Namen "MyTxTargetDescDeInit" zu definieren, verwenden Sie den MINIPORT_WDI_TX_TARGET_DESC_DEINIT-Typ , wie in diesem Codebeispiel gezeigt:

MINIPORT_WDI_TX_TARGET_DESC_DEINIT MyTxTargetDescDeInit;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
VOID
 MyTxTargetDescDeInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL
    )
  {...}

Der MINIPORT_WDI_TX_TARGET_DESC_DEINIT Funktionstyp ist in der Headerdatei dot11wdi.h definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, fügen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzu. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den MINIPORT_WDI_TX_TARGET_DESC_DEINIT Funktionstyp in der Headerdatei angewendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für NDIS-Treiber.

Informationen zu Use_decl_annotations finden Sie unter Verhalten von Funktionen mit Anmerkungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	dot11wdi.h