MINIPORT_WDI_TX_ABORT 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 MiniportWdiTxAbort-Handlerfunktion bricht ausstehende TX-Frames für einen bestimmten Port oder Peer ab. Dies schließt das Initiieren der Vervollständigung von Frames im Besitz der TAL/des Ziels ein. Diese Anforderung wird im Rahmen der Behandlung von MiniportPause (adapterweiter TX-Abbruch), dot11 reset (portweiter Abbruch) und nach NdisWdiPeerDeleteIndication ausgegeben, wenn WDI im Peer queuing-Modus ausgeführt wird.

Dies ist ein WDI-Miniporthandler innerhalb NDIS_MINIPORT_WDI_DATA_HANDLERS.

Hinweis Sie müssen die Funktion mit dem typ MINIPORT_WDI_TX_ABORT deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt Beispiele.

Syntax

MINIPORT_WDI_TX_ABORT MiniportWdiTxAbort;

void MiniportWdiTxAbort(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parameter

[in] MiniportTalTxRxContext

TAL-Gerätehandle, das vom IHV-Miniport in MiniportWdiTalTxRxInitialize zurückgegeben wird.

[in] PortId

Die Port-ID.

[in] PeerId

Die Peer-ID.

[out] pWifiStatus

Zeiger auf eine status des MiniportWdiTxAbort, der vom IHV-Miniport festgelegt werden sollte. Weitere Informationen finden Sie im Abschnitt Bemerkungen.

Rückgabewert

Keine

Bemerkungen

Es kann ein Wildcard für die PeerId angegeben werden, um TX an einem Port zu beenden.

Es kann ein Wildcard für PortId und PeerId angegeben werden, um TX über den Adapter zu beenden.

Um den Stoppvorgang abzuschließen, muss die TAL die folgenden Schritte ausführen.

Initiieren Sie die Rückgabe des Besitzes von TX-Datenpuffern, die den Eingabeparametern für den Host entsprechen. Diese Frames sollten abgeschlossen werden, indem der Übertragungsabschluss für alle an die TxEngine übergebenen Frames in Sendeanforderungen und die Angabe von NdisWdiTxSendCompleteIndication für ausstehende TX-Frames angegeben werden, die eine explizite Sendevervollständigung erfordern (wenn der TX-Frame nicht mit einem Erfolgscode übertragen wurde).
Geben Sie eine erfolgreiche status zurück, oder geben Sie eine ausstehende status zurück, und geben Sie NdisWdiTxAbortConfirm später aus.

Beispiele

Um eine MiniportWdiTxAbort-Funktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der zu definierenden Funktion identifiziert. Windows bietet eine Reihe von Funktionstypen für Treiber. 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 Voraussetzung für das Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine MiniportWdiTxAbort-Funktion mit dem Namen "MyTxAbort" zu definieren, verwenden Sie den typ MINIPORT_WDI_TX_ABORT , wie in diesem Codebeispiel gezeigt:

MINIPORT_WDI_TX_ABORT MyTxAbort;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
VOID
 MyTxAbort(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    NDIS_STATUS *pWifiStatus
    )
  {...}

Der MINIPORT_WDI_TX_ABORT Funktionstyp ist in der Headerdatei dot11wdi.h definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, müssen Sie der Funktionsdefinition die anmerkung Use_decl_annotations hinzufügen. Die Use_decl_annotations-Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den MINIPORT_WDI_TX_ABORT 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