en-tête dot11wdi.h

Article
03/13/2025

Cet en-tête est utilisé par le réseau. Pour plus d’informations, consultez :

réseau

dot11wdi.h contient les interfaces de programmation suivantes :

Fonctions


NdisMDeregisterWdiMiniportDriver Un pilote miniport appelle la fonction NdisMDeregisterWdiMiniportDriver pour libérer les ressources qu’elle a allouées avec un appel précédent à la fonction NdisMRegisterWdiMiniportDriver.
NdisMRegisterWdiMiniportDriver Un pilote miniport appelle la fonction NdisMRegisterWdiMiniportDriver pour inscrire les points d’entrée MiniportWdiXxx auprès de NDIS comme première étape de l’initialisation.

Fonctions de rappel


MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE La fonction de gestionnaire MiniportWdiAdapterHangDiagnose est utilisée pour collecter les états du registre de contrôle matériel et éventuellement l’état complet du microprogramme.
MINIPORT_WDI_ALLOCATE_ADAPTER La fonction de gestionnaire MiniportWdiAllocateAdapter alloue un adaptateur miniport WDI.
MINIPORT_WDI_CANCEL_IDLE_NOTIFICATION NDIS appelle la fonction de gestionnaire MiniportWdiCancelIdleNotification pour avertir le pilote miniport WDI que NDIS a détecté l’activité sur la carte réseau suspendue.
MINIPORT_WDI_CLOSE_ADAPTER La fonction de gestionnaire MiniportWdiCloseAdapter est utilisée par le composant Microsoft pour lancer l’opération Close Task sur le pilote IHV.
MINIPORT_WDI_FREE_ADAPTER La fonction de gestionnaire MiniportWdiFreeAdapter demande que le pilote IHV supprime son état logiciel.
MINIPORT_WDI_IDLE_NOTIFICATION NDIS appelle la fonction de gestionnaire MiniportWdiIdleNotification pour démarrer l’opération de suspension sélective NDIS sur une carte réseau inactive. Grâce à cette opération, la carte réseau est suspendue et transférée vers un état de faible alimentation.
MINIPORT_WDI_OPEN_ADAPTER La fonction de gestionnaire MiniportWdiOpenAdapter est utilisée par le composant Microsoft pour lancer l’opération Open Task sur le pilote IHV.
MINIPORT_WDI_POST_ADAPTER_PAUSE La fonction de gestionnaire MiniportWdiPostAdapterPause est appelée par le composant Microsoft une fois le chemin de données nettoyé dans le cadre des exigences NDIS MiniportPause.
MINIPORT_WDI_POST_ADAPTER_RESTART La fonction de gestionnaire MiniportWdiPostAdapterRestart est appelée par le composant Microsoft une fois le redémarrage du chemin de données terminé dans le cadre des exigences NDIS MiniportRestart.
MINIPORT_WDI_RX_FLUSH La fonction de gestionnaire MiniportWdiRxFlush est émise une fois l’opération MiniportWdiRxStop terminée. Lors de la réception de la demande de vidage, la cible/RxEngine doit ignorer toutes les trames non associées sur le port/adaptateur avant d’indiquer RxFlushConfirm.
MINIPORT_WDI_RX_GET_MPDUS La fonction de gestionnaire MiniportWdiRxGetMpdus retourne une chaîne NET_BUFFER_LIST. Chaque NET_BUFFER_LIST représente un MPDU.
MINIPORT_WDI_RX_PPDU_RSSI La fonction de gestionnaire MiniportWdiRxPpduRssi retourne la valeur absolue de RSSI (en dB) pour le PPDU. RxMgr peut demander le RSSI une seule fois par indication de données à l’aide du PNET_BUFFER_LIST obtenu à partir de MiniportWdiRxGetMpdus.
MINIPORT_WDI_RX_RESTART La fonction de gestionnaire MiniportWdiRxRestart configure rxEngine pour redémarrer en indiquant le trafic de données. Ceci est émis après un MiniportWdiRxStop.
MINIPORT_WDI_RX_RESUME La fonction de gestionnaire MiniportWdiRxResume est émise par rxMgr après qu’elle retourne un état de pause à une indication de données.
MINIPORT_WDI_RX_RETURN_FRAMES La fonction de gestionnaire MiniportWdiRxReturnFrames retourne une structure NET_BUFFER_LIST (et des mémoires tampons de données associées) au tal.
MINIPORT_WDI_RX_STOP La fonction de gestionnaire MiniportWdiRxStop arrête RX sur un port donné et accepte l’ID de port générique pour arrêter RX sur l’adaptateur.
MINIPORT_WDI_RX_THROTTLE La fonction de gestionnaire MiniportWdiRxThrottle indique à tal/cible d’activer les mécanismes pour réduire le taux de MSDU RX.
MINIPORT_WDI_START_ADAPTER_OPERATION La fonction de gestionnaire MiniportWdiStartAdapterOperation peut être utilisée par le pilote IHV pour effectuer des tâches MiniportInitializeEx supplémentaires.
MINIPORT_WDI_STOP_ADAPTER_OPERATION La fonction de gestionnaire MiniportWdiStopAdapterOperation peut être utilisée par le pilote IHV pour annuler les opérations effectuées dans MiniportWdiStartAdapterOperation.
MINIPORT_WDI_TAL_TXRX_ADD_PORT La fonction de gestionnaire MiniportWdiTalTxRxAddPort notifie les composants datapath de la création d’un nouveau port virtuel.
MINIPORT_WDI_TAL_TXRX_DEINITIALIZE La fonction de gestionnaire MiniportWdiTalTxRxDeinitialize est appelée dans le contexte de l’arrêt miniport. Les composants fonctionnels RXEngine et TxEngine ont déjà été arrêtés et les trames de données en attente terminées/retournées.
MINIPORT_WDI_TAL_TXRX_DELETE_PORT La fonction de gestionnaire MiniportWdiTalTxRxDeletePort notifie les composants datapath de la suppression d’un port virtuel.
MINIPORT_WDI_TAL_TXRX_INITIALIZE 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.
MINIPORT_WDI_TAL_TXRX_PEER_CONFIG La fonction de gestionnaire MiniportWdiTalTxRxPeerConfig spécifie l’ID de port, l’ID d’homologue et les fonctionnalités d’homologue (par exemple, les fonctionnalités QoS). Elle est appelée une fois que l’homologue a associé, ce qui implique la création de l’objet homologue dans le tal.
MINIPORT_WDI_TAL_TXRX_PEER_DELETE_CONFIRM La fonction de gestionnaire MiniportWdiTalTxRxPeerDeleteConfirm est appelée après l’achèvement d’un appel PeerDeleteIndication qui n’a pas retourné de réussite.
MINIPORT_WDI_TAL_TXRX_RESET_PORT La fonction de gestionnaire MiniportWdiTalTxRxResetPort est appelée avant l’émission d’une tâche de réinitialisation dot11 à la cible.
MINIPORT_WDI_TAL_TXRX_SET_PORT_OPMODE La fonction de gestionnaire MiniportWdiTalTxRxSetPortOpMode spécifie l’opmode utilisé pour le port afin que TxEngine et RxEngine activent les fonctionnalités correspondantes.
MINIPORT_WDI_TAL_TXRX_START La fonction de gestionnaire MiniportWdiTalTxRxStart fournit des paramètres de configuration TXRX au TAL.
MINIPORT_WDI_TAL_TXRX_STOP La fonction de gestionnaire MiniportWdiTalTxRxStop arrête la communication TXRX entre la fonction TAL et la cible.
MINIPORT_WDI_TX_ABORT La fonction du gestionnaire MiniportWdiTxAbort abandonne les images TX en attente pour un port ou un homologue donné, ce qui inclut le lancement de l’achèvement des images détenues par le TAL/target.
MINIPORT_WDI_TX_DATA_SEND La fonction de gestionnaire MiniportWdiTxDataSend spécifie un RA-TID ou une file d’attente de ports à partir duquel transmettre. Il est émis dans le contexte du thread TX du système d’exploitation, de l’indication de reprise ou d’un élément de travail.
MINIPORT_WDI_TX_PEER_BACKLOG La fonction de gestionnaire MiniportWdiTxPeerBacklog est émise lorsqu’un homologue suspendu a un changement d’état du backlog.
MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT La fonction de rappel TxSuspectFrameListAbort est implémentée par le pilote client pour informer TxEngine que txMgr a identifié des images qui sont soupçonnées d’être suspendues ou en attente pendant une durée importante.
MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER La fonction de gestionnaire MiniportWdiTxTalQueueInOrder informe la cible TAL qu’une ou plusieurs files d’attente RA/TID suspendues (avec WDI_TX_PAUSE_REASON_PS) sont prêtes à transmettre.
MINIPORT_WDI_TX_TAL_SEND La fonction de gestionnaire MiniportWdiTxTalSend spécifie une file d’attente de ports ou de RA-TID à transmettre.
MINIPORT_WDI_TX_TAL_SEND_COMPLETE La fonction de gestionnaire MiniportWdiTxTalSendComplete retourne la propriété d’une ou plusieurs trames TX injectées par le TAL au TxEngine.
MINIPORT_WDI_TX_TARGET_DESC_DEINIT La fonction de rappel MINIPORT_WDI_TX_TARGET_DESC_DEINIT informe txEngine que les descripteurs TX cibles associés à la NET_BUFFER_LIST (NBLs) de la chaîne NBL ne sont plus nécessaires et peuvent être libérés.
MINIPORT_WDI_TX_TARGET_DESC_INIT La fonction de rappel MINIPORT_WDI_TX_TARGET_DESC_INIT associe un descripteur TX cible opaque au champ NET_BUFFER_LIST (MiniportReserved[1] et (le cas échéant) remplit le champ de coût TX (en unités de crédit) dans la mémoire tampon WDI_FRAME_METADATA du NET_BUFFER_LIST (MiniportReserved[0]).
NDIS_WDI_ALLOCATE_WDI_FRAME_METADATA La fonction de rappel NdisWdiAllocateWiFiFrameMetaData alloue une mémoire tampon de métadonnées d’image.
NDIS_WDI_CLOSE_ADAPTER_COMPLETE La fonction de rappel NdisWdiCloseAdapterComplete est appelée par l’IHV lorsqu’une opération Close Task de MiniportWdiCloseAdapter a été démarrée avec succès.
NDIS_WDI_FREE_WDI_FRAME_METADATA La fonction de rappel NdisWdiFreeWiFiFrameMetaData libère une mémoire tampon de métadonnées de frame.
NDIS_WDI_IDLE_NOTIFICATION_COMPLETE Les pilotes miniport appellent la fonction de rappel NdisWdiIdleNotificationComplete pour terminer une notification inactive en attente pour une opération de suspension sélective NDIS. NDIS démarre l’opération lorsqu’elle appelle la fonction de gestionnaire MiniportWdiIdleNotification du pilote.
NDIS_WDI_IDLE_NOTIFICATION_CONFIRM Les pilotes miniport appellent la fonction de rappel NdisWdiIdleNotificationConfirm pour informer NDIS que la carte réseau inactive peut être suspendue et transférée en toute sécurité vers un état à faible alimentation.
NDIS_WDI_OPEN_ADAPTER_COMPLETE La fonction de rappel NdisWdiOpenAdapterComplete est appelée par l’IHV lorsqu’une opération Open Task de MiniportWdiOpenAdapter a été démarrée avec succès.
NDIS_WDI_PEER_CREATE_IND La fonction de rappel NdisWdiPeerCreateIndication spécifie un ID d’homologue à associer à une adresse MAC homologue.
NDIS_WDI_PEER_DELETE_IND La fonction de rappel NdisWdiPeerDeleteIndication lance la suppression de l’association entre un ID d’homologue et une adresse MAC homologue.
NDIS_WDI_RX_FLUSH_CONFIRM La fonction de rappel NdisWdiRxFlushConfirm indique l’achèvement d’une requête MiniportWdiRxFlush. RxEngine doit terminer l’abandon de toutes les trames de données RX qui correspondent à la demande de vidage avant d’émettre NdisWdiRxFlushConfirm.
NDIS_WDI_RX_INORDER_DATA_IND La fonction de rappel NdisWdiRxInorderDataIndication informe le RxMgr qu’une liste de trames RX spécifiées dans l’ordre correct est présente.
NDIS_WDI_RX_STOP_CONFIRM La fonction de rappel NdisWdiRxStopConfirm indique l’achèvement d’une requête MiniportWdiRxStop.
NDIS_WDI_TX_ABORT_CONFIRM La fonction de rappel NdisWdiTxAbortConfirm indique une confirmation asynchrone d’un MiniportWdiTxAbort à partir de WDI.
NDIS_WDI_TX_DEQUEUE_IND La fonction de rappel NdisWdiTxDequeueIndication est appelée dans le contexte d’un miniportWdiTxDataSend ou MiniportWdiTxTalSend par le miniport IHV pour déqueue des trames de WDI vers le miniport IHV.
NDIS_WDI_TX_INJECT_FRAME_IND La fonction de rappel NdisWdiTxInjectFrameIndication permet à l’instance DE d’injecter des images via le chemin de données standard (par exemple, les requêtes/réponses d’authentification/association, Wi-Fi les trames d’action directes).
NDIS_WDI_TX_QUERY_RA_TID_STATE La fonction de rappel NdisWdiTxQueryRATIDState est utilisée par TxEngine pour interroger l’état d’une file d’attente RA/TID ou Port.
NDIS_WDI_TX_QUERY_SUSPECT_FRAME_COMPLETE_STATUS La fonction de rappel TxQuerySuspectFrameStatus est implémentée par le miniport IHV pour interroger l’état d’une trame suspecte.
NDIS_WDI_TX_RELEASE_FRAMES_IND La fonction de rappel NdisWdiTxReleaseFrameIndication libère jusqu’à un nombre spécifié ou un coût agrégé d’images mis en file d’attente vers une combinaison peer-TID donnée lorsque la transmission est suspendue.
NDIS_WDI_TX_SEND_COMPLETE_IND La fonction de rappel NdisWdiTxSendCompleteIndication spécifie un tableau d’ID d’images associés aux images envoyées de la cible.
NDIS_WDI_TX_SEND_PAUSE_IND La fonction de rappel NdisWdiTxSendPauseIndication interrompt les transmissions sur un port donné vers une combinaison pair ou pair-TID donnée.
NDIS_WDI_TX_SEND_RESTART_IND La fonction de rappel NdisWdiTxSendRestartIndication reprend la transmission sur un port donné vers une combinaison peer-TID donnée.
NDIS_WDI_TX_TRANSFER_COMPLETE_IND La fonction de rappel NdisWdiTxTransferCompleteIndication spécifie une liste de mémoires tampons d’images qui ont été transférées vers la cible. Les images avec différentes valeurs d’état TX sont terminées dans des indications distinctes.

Structures


NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS La structure NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS définit l’ensemble des gestionnaires qu’un pilote miniport WDI doit implémenter.
NDIS_MINIPORT_WDI_DATA_HANDLERS La structure NDIS_MINIPORT_WDI_DATA_HANDLERS spécifie les points d’entrée pour les gestionnaires de chemins de données miniport IHV.
NDIS_WDI_DATA_API La structure NDIS_WDI_DATA_API spécifie les points d’entrée pour les indications de données WDI.
NDIS_WDI_INIT_PARAMETERS La structure NDIS_WDI_INIT_PARAMETERS spécifie les fonctions WDI fournies par le système d’exploitation et appelées par le pilote WDI IHV.
TAL_TXRX_PARAMETERS La structure TAL_TXRX_PARAMETERS définit les paramètres TAL TXRX.
WDI_FRAME_METADATA La structure WDI_FRAME_METADATA définit les métadonnées de trame.
WDI_MAC_ADDRESS La structure WDI_MAC_ADDRESS définit une adresse MAC (Media Access Control) IEEE.
WDI_MESSAGE_HEADER La structure WDI_MESSAGE_HEADER définit l’en-tête de message WDI. Tous les messages de commande WDI doivent commencer par cet en-tête.
WDI_P2P_SERVICE_NAME_HASH La structure WDI_P2P_SERVICE_NAME_HASH définit un hachage d’un nom de service WFDS.
WDI_RX_METADATA La structure WDI_RX_METADATA définit les métadonnées RX.
WDI_TX_COMPLETE_DATA La structure WDI_TX_COMPLETE_DATA définit les données d’achèvement TX.
WDI_TX_METADATA La structure WDI_TX_METADATA définit les métadonnées TX.
WDI_TXRX_CAPABILITIES La structure WDI_TXRX_CAPABILITIES définit les fonctionnalités cibles.
WDI_TXRX_MPDU_PN L’union WDI_TXRX_MPDU_PN définit les paramètres transmis au composant TXRX.
WDI_TXRX_PARAMETERS La structure WDI_TXRX_PARAMETERS définit les paramètres transmis au composant TXRX.
WDI_TXRX_PEER_CFG La structure WDI_TXRX_PEER_CFG définit la configuration d’homologue.
WDI_TXRX_TARGET_CONFIGURATION La structure WDI_TXRX_TARGET_CONFIGURATION définit la configuration cible.

Énumérations


eDiagnoseLevel L’énumération eDiagnoseLevel définit les niveaux de diagnostic pour le diagnostic de blocage de l’adaptateur.
WDI_EXEMPTION_ACTION_TYPE L’énumération WDI_EXEMPTION_ACTION_TYPE définit les types d’exemption.
WDI_FRAME_PAYLOAD_TYPE L’énumération WDI_FRAME_PAYLOAD_TYPE définit le type de charge utile d’image.
WDI_INTERCONNECT_TYPE L’énumération WDI_INTERCONNECT_TYPE définit les types d’interconnexion.
WDI_OPERATION_MODE L’énumération WDI_OPERATION_MODE définit les modes d’opération.
WDI_RX_INDICATION_LEVEL L’énumération WDI_RX_INDICATION_LEVEL définit les niveaux d’indication RX.
WDI_RX_THROTTLE_LEVEL L’énumération WDI_RX_THROTTLE_LEVEL définit le niveau de limitation RX. Les mécanismes d’interprétation et d’implémentation de ces niveaux de limitation sont définis par le fournisseur de matériel indépendant (IHV).
WDI_TX_FRAME_STATUS L’énumération WDI_TX_FRAME_STATUS définit les valeurs d’état d’image TX.
WDI_TX_PAUSE_REASON L’énumération WDI_TX_PAUSE_REASON définit les raisons d’une pause TX.
WDI_TXRX_PEER_QOS_CAPS L’énumération WDI_TXRX_PEER_QOS_CAPS définit les fonctionnalités de qualité de service (QoS).

Partager via

en-tête dot11wdi.h

Fonctions

Fonctions de rappel

Structures

Énumérations

Commentaires

Ressources supplémentaires