MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion (dot11wdi.h)

Artikel
02/06/2025

Wichtig

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

Die MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion informiert die TxEngine, dass die TX-Zieldeskriptoren, die der 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 innerhalb NDIS_MINIPORT_WDI_DATA_HANDLERS.

Hinweis Sie müssen die Funktion mithilfe des typs MINIPORT_WDI_TX_TARGET_DESC_DEINIT 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

Nichts

Bemerkungen

Wichtig Der IHV-Miniport darf im Rahmen dieses Aufrufs keinen Hinweis geben. TxMgr serialisiert Aufrufe an TxTargetDescDeInitHandler.

Beispiele

Um eine MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration bereitstellen, die den Typ der Funktion identifiziert, die Sie definieren. Windows stellt eine Reihe von Funktionstypen für Treiber bereit. Durch das Deklarieren einer Funktion mithilfe der Funktionstypen können Codeanalyse für Treiber, statische Treiberüberprüfung (SDV) und andere Überprüfungstools Fehler finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Wenn Sie beispielsweise eine MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion mit dem Namen "MyTxTargetDescDeInit" definieren möchten, 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 wird in der Headerdatei dot11wdi.h definiert. Um Fehler genauer zu identifizieren, wenn Sie die Codeanalysetools ausführen, müssen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzufügen. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen, die auf den Funktionstyp MINIPORT_WDI_TX_TARGET_DESC_DEINIT in der Headerdatei angewendet werden, verwendet 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_annotationsfinden Sie unter Annotating Function Behavior.