MINIPORT_WDI_TX_TARGET_DESC_INIT 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_INIT Rückruffunktion ordnet dem NET_BUFFER_LIST (MiniportReserved[1]- Feld) einen undurchsichtigen TX-Zieldeskriptor zu und füllt (falls zutreffend) das TX-Kostenfeld (in Krediteinheiten) im WDI_FRAME_METADATA Puffer des NET_BUFFER_LIST auf (MiniportReserved[0]).

Dies ist ein WDI-Miniporthandler innerhalb NDIS_MINIPORT_WDI_DATA_HANDLERS.

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

Syntax

MINIPORT_WDI_TX_TARGET_DESC_INIT MiniportWdiTxTargetDescInit;

void MiniportWdiTxTargetDescInit(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  PNET_BUFFER_LIST pNBL,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parameter

[in] MiniportTalTxRxContext

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

[in] pNBL

Zeiger auf eine einzelne NET_BUFFER_LIST.

[out] pWifiStatus

Zeiger auf die vom IHV festgelegte status, um das Ergebnis der MINIPORT_WDI_TX_TARGET_DESC_INIT Rückruffunktion anzugeben.

Rückgabewert

Keine

Bemerkungen

Eine status von NDIS_STATUS_RESOURCES darf nur verwendet werden, wenn Tx-Deskriptoren erschöpft sind. Das beste Verhalten tritt auf, wenn der IHV-Miniport nicht NDIS_STATUS_RESOURCES verwendet. Alle anderen status als NDIS_STATUS_SUCCESS und NDIS_STATUS_RESOURCES müssen für alle anderen Fehler verwendet werden, die darauf hindeuten, dass der IHV-Miniport oder die Firmware den NET_BUFFER_LIST nicht verarbeiten kann.

Der IHV-Miniport kann den Nachfüller im NET_BUFFER mithilfe der entsprechenden NDIS-Rückzugs- und Advance-Funktionen nutzen. Der Anfang des Paketoffsets muss vor oder in der MINIPORT_WDI_TX_TARGET_DESC_DEINIT Rückruffunktion wiederhergestellt werden. TxMgr bestimmt die Framelänge während der Dequeuezeit, sodass jede Änderung der Framelänge in der MINIPORT_WDI_TX_TARGET_DESC_INIT Rückruffunktion in die Begrenzung der Größe der Dequeue auf die Quanten einbezogen wird. In diesem Fall sollte der IHV-Miniport die Quanten entsprechend anpassen, um das Delta zu berücksichtigen.

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

Beispiele

Um eine MINIPORT_WDI_TX_TARGET_DESC_INIT Rückruffunktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der von Ihnen definierten 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.

Wenn Sie beispielsweise eine MINIPORT_WDI_TX_TARGET_DESC_INIT Rückruffunktion mit dem Namen "MyTxTargetDescInit" definieren möchten, verwenden Sie den typ MINIPORT_WDI_TX_TARGET_DESC_INIT , wie in diesem Codebeispiel gezeigt:

MINIPORT_WDI_TX_TARGET_DESC_INIT MyTxTargetDescInit;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
VOID
 MyTxTargetDescInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL,
    NDIS_STATUS *pWifiStatus
    )
  {...}

Der MINIPORT_WDI_TX_TARGET_DESC_INIT 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_TARGET_DESC_INIT 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