MINIPORT_WDI_TAL_TXRX_INITIALIZE fonction de rappel (dot11wdi.h)

Article
02/06/2025

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 la bibliothèque TAL et échange les handles de composant datapath entre UE et TAL. Ceci 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 miniport WDI à l’intérieur NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

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

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 for the IHV miniport to use in datapath indications.

[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 d’accès 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 qui sont sécurisées pour initialiser en fonction des règles de contrôle de version NDIS traditionnelles. Le LE est chargé de mettre à jour l’en-tête avec la révision et la taille que le LE implémente et prend en charge avant de retourner.

[out] pMiniportWdiFrameMetadataExtraSpace

Le paramètre 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 pour que LE utilise.