MINIPORT_WDI_TX_ABORT 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 MiniportWdiTxAbort-Handlerfunktion bricht herausragende TX-Frames für einen bestimmten Port oder Peer ab, der das Initiieren des Abschlusses von Frames im Besitz des TAL/Ziels umfasst. Diese Anforderung wird im Rahmen der Behandlung MiniportPause (adapterweite TX-Abort), dot11 reset (port-wide abort) und nach NdisWdiPeerDeleteIndication, wenn WDI im Peer queuing-Modus ausgeführt wird.

Dies ist ein WDI-Miniporthandler innerhalb NDIS_MINIPORT_WDI_DATA_HANDLERS.

Note You must declare the function by using the MINIPORT_WDI_TX_ABORT type. 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, der vom IHV miniport in MiniportWdiTalTxRxInitializezurückgegeben wird.

[in] PortId

Die Port-ID.

[in] PeerId

Die Peer-ID.

[out] pWifiStatus

Zeigen Sie auf einen Status des MiniportWdiTxAborts, der vom IHV-Miniport festgelegt werden soll. Weitere Informationen finden Sie im Abschnitt Anmerkungen.

Rückgabewert

Nichts

Bemerkungen

Ein Wildcard kann für die PeerId- angegeben werden, um TX auf einem Port zu beenden.

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

Um den Stoppvorgang abzuschließen, muss das 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 den TxEngine in Sendeanforderungen übergebenen Frames angegeben wird und NdisWdiTxSendCompleteIndication- für herausragende TX-Frames angegeben wird, die expliziten Sendevorgang erfordern (wenn der TX-Frame nicht mit einem Erfolgscode übertragen wurde).
Zurückgeben eines Erfolgsstatus oder Zurückgeben eines ausstehenden Status und Problem NdisWdiTxAbortConfirm später.

Beispiele

Um eine MiniportWdiTxAbort-Funktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration angeben, 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.

Um beispielsweise eine MiniportWdiTxAbort-Funktion zu definieren, die den Namen "MyTxAbort" hat, verwenden Sie den MINIPORT_WDI_TX_ABORT Typ, 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 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_ABORT 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.