MINIPORT_WDI_TAL_TXRX_INITIALIZE fonction de rappel (dot11wdi.h)

Article
02/26/2024

Important

Cette rubrique fait partie du modèle de pilote WDI publié dans Windows 10. Le modèle de pilote WDI est en mode maintenance et ne reçoit que des correctifs de priorité élevée. WiFiCx est le modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

La fonction de gestionnaire MiniportWdiTalTxRxInitialize initialise les structures de données dans le TAL et échange les handles du composant datapath entre ue et TAL. Il est émis dans le contexte de l’initialisation du pilote et est émis avant d’interroger le microprogramme pour les fonctionnalités de l’appareil.

Il s’agit d’un gestionnaire de miniport WDI à l’intérieur de NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Note Vous devez déclarer la fonction à l’aide du type MINIPORT_WDI_TAL_TXRX_INITIALIZE . Pour plus d’informations, consultez la section Exemples suivante.

Syntaxe

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
)
{...}

Paramètres

[in] MiniportAdapterContext

Handle pour le contexte miniport IHV.

[in] NdisMiniportDataPathHandle

Handle pour le miniport IHV à utiliser dans les indications de chemin de données.

[in] NdisWdiDataPathApi

Pointeur vers la table de fonctions de l’API de données WDI.

[out] pMiniportTalTxRxContext

Le handle d’appareil TAL est un handle de chemin de contrôle pour l’appareil (par exemple, MiniportContext). Il est associé au MiniportHandle, utilisé comme contexte pour les appels d’API NDIS.

[in, out] pMiniportDataHandlers

L’UE initialise le champ d’en-tête NDIS afin que le LE puisse déterminer la révision et la taille à initialiser en toute sécurité en fonction des règles de contrôle de version NDIS traditionnelles. Le LE est responsable de la mise à jour de l’en-tête avec la révision et la taille que le LE implémente et prend en charge avant le retour.

[out] pMiniportWdiFrameMetadataExtraSpace

Le LE définit la valeur pointée par ce paramètre sur la quantité d’espace que WDI doit réserver après l’WDI_FRAME_METADATA que le LE doit utiliser.

Valeur retournée

Note Les valeurs de retour non NDIS_STATUS_SUCCESS indiquent un échec générique.

Code de retour	Description
NDIS_STATUS_SUCCESS	Indique que le pilote miniport a correctement échangé le composant datapath.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
En-tête	dot11wdi.h

Voir aussi

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

Interfaces de chemin de données générales WDI

WDI_FRAME_METADATA

Partager via