MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 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 MiniportWdiTxTalQueueInOrder-Funktion benachrichtigt das TAL-Ziel, dass mindestens eine angehaltene RA/TID-Warteschlange (mit WDI_TX_PAUSE_REASON_PS) für die Übertragung bereit ist.

Dies bedeutet:

Jede der Warteschlangen verfügt über keine ausstehenden TX-Frames mit TAL/Target.
Alle Frames, die TX mit WDI_TxFrameStatus_SendPostponed abgeschlossen waren, wurden in die RA-TID Warteschlange in der richtigen Reihenfolge eingefügt.

Dies ist ein WDI-Miniporthandler innerhalb NDIS_MINIPORT_WDI_DATA_HANDLERS.

Hinweis Sie müssen die Funktion mithilfe des typs MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt "Beispiele".

Syntax

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MiniportWdiTxTalQueueInOrder;

void MiniportWdiTxTalQueueInOrder(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PEER_ID PeerId,
  [in] UINT32 ExTidBitmask
)
{...}

Parameter

[in] MiniportTalTxRxContext

TAL-Gerätehandle, der vom IHV miniport in MiniportWdiTalTxRxInitializezurückgegeben wird.

[in] PeerId

Die Peer-ID.

[in] ExTidBitmask

Die erweiterte TID-Bitmaske.

Rückgabewert

Nichts

Bemerkungen

Das TAL/Target wartet auf diese Benachrichtigung, bevor eine TX-Neustartanzeige für eine angehaltene Warteschlange mit WDI_TX_PAUSE_REASON_PSausgegeben wird.

HinweisWDI_TxFrameStatus_SendPostponed ist nicht zulässig, wenn TargetPriorityQueueing- WAHR ist, sodass diese Anforderung niemals in diesem Modus erfolgt.

Beispiele

Um eine MiniportWdiTxTalQueueInOrder-Funktion 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.

Um beispielsweise eine MiniportWdiTxTalQueueInOrder-Funktion zu definieren, die den Namen "MyTxTalQueueInOrder" hat, verwenden Sie den MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER Typ, wie in diesem Codebeispiel gezeigt:

MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MyTxTalQueueInOrder;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
VOID
 MyTxTalQueueInOrder(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PEER_ID PeerId,
    UINT32 ExTidBitmask
    )
  {...}

Der MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER 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_TAL_QUEUE_IN_ORDER 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.