MINIPORT_WDI_TAL_TXRX_INITIALIZE 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 MiniportWdiTalTxRxInitialize-Handlerfunktion initialisiert Datenstrukturen in der TAL und tauscht Datenpfadkomponentenhandles zwischen UE und TAL aus. Dies wird im Kontext der Treiberinitialisierung ausgegeben und vor dem Abfragen der Firmware für die Gerätefunktionen ausgegeben.

Dies ist ein WDI-Miniporthandler in NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Hinweis Sie müssen die Funktion mit dem MINIPORT_WDI_TAL_TXRX_INITIALIZE-Typ deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt Beispiele.

Syntax

MINIPORT_WDI_TAL_TXRX_INITIALIZE MiniportWdiTalTxrxInitialize;

NDIS_STATUS MiniportWdiTalTxrxInitialize(
  [in]      NDIS_HANDLE MiniportAdapterContext,
  [in]      NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]      PNDIS_WDI_DATA_API NdisWdiDataPathApi,
  [out]     PTAL_TXRX_HANDLE pMiniportTalTxRxContext,
  [in, out] PNDIS_MINIPORT_WDI_DATA_HANDLERS pMiniportDataHandlers,
  [out]     UINT32 *pMiniportWdiFrameMetadataExtraSpace
)
{...}

Parameter

[in] MiniportAdapterContext

Handle für den IHV-Miniportkontext.

[in] NdisMiniportDataPathHandle

Handle für den IHV-Miniport, der in Datapath-Indikationen verwendet werden soll.

[in] NdisWdiDataPathApi

Zeiger auf die WDI-Daten-API-Funktionstabelle.

[out] pMiniportTalTxRxContext

Das TAL-Gerätehandle ist ein Steuerungspfadhandle für das Gerät (z. B. MiniportContext). Sie ist dem MiniportHandle zugeordnet, das als Kontext für NDIS-API-Aufrufe verwendet wird.

[in, out] pMiniportDataHandlers

Die UE initialisiert das Feld NDIS-Header, damit die LE die Revision und Größe bestimmen kann, die gemäß herkömmlichen NDIS-Versionsverwaltungsregeln sicher initialisiert werden kann. Die LE ist für das Aktualisieren des Headers mit der Revision und Größe verantwortlich, die die LE tatsächlich implementiert und vor der Rückgabe unterstützt.

[out] pMiniportWdiFrameMetadataExtraSpace

Die LE legt den Wert fest, auf den dieser Parameter verweist, auf die Menge des Speicherplatzes, den WDI nach dem WDI_FRAME_METADATA für die LE reservieren soll.

Rückgabewert

Hinweis Nicht NDIS_STATUS_SUCCESS Rückgabewerte weisen auf einen generischen Fehler hin.

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Gibt an, dass der Miniporttreiber die Datenpfadkomponentenhandles erfolgreich ausgetauscht hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	dot11wdi.h

Weitere Informationen

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

Allgemeine WDI-Datenpfadschnittstellen

WDI_FRAME_METADATA

Freigeben über