structure DOT11_EXTSTA_SEND_CONTEXT (windot11.h)

Article
02/07/2025

Important

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

La structure DOT11_EXTSTA_SEND_CONTEXT définit les attributs natifs 802.11 d’un paquet à envoyer par le pilote miniport fonctionnant en mode Extensible Station (ExtSTA). Pour plus d’informations sur ce mode d’opération, consultez mode d’opération de station extensible.

Syntaxe

typedef struct DOT11_EXTSTA_SEND_CONTEXT {
  NDIS_OBJECT_HEADER Header;
  USHORT             usExemptionActionType;
  ULONG              uPhyId;
  ULONG              uDelayedSleepValue;
  PVOID              pvMediaSpecificInfo;
  ULONG              uSendFlags;
} DOT11_EXTSTA_SEND_CONTEXT, *PDOT11_EXTSTA_SEND_CONTEXT;

Membres

Header

Type, révision et taille de la structure DOT11_EXTSTA_SEND_CONTEXT. Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER.

Le pilote miniport doit définir les membres de l’en-tête sur les valeurs suivantes :

Type

Ce membre doit être défini sur NDIS_OBJECT_TYPE_DEFAULT.

Révision

Ce membre doit être défini sur DOT11_EXTSTA_SEND_CONTEXT_REVISION_1.

Taille

Ce membre doit être défini sur sizeof(DOT11_EXTSTA_SEND_CONTEXT).

Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.

usExemptionActionType

Type d’exemption de chiffrement pour le paquet. Les types d’exemption suivants sont définis :

DOT11_EXEMPT_NO_EXEMPTION

Le paquet n’est exempt d’aucune opération de chiffrement effectuée par la station 802.11.

DOT11_EXEMPT_ALWAYS

Le paquet est exempté de toutes les opérations de chiffrement effectuées par la station 802.11. La station 802.11 doit transmettre le paquet non chiffré.

DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE

Le paquet est exempté des opérations de chiffrement effectuées par la station 802.11 uniquement si la station n’a pas de clé de mappage de clé pour l’adresse MAC (Destination Media Access Control) du paquet. Pour plus d’informations sur les clés de mappage de clés, consultez 802.11 Types de clés de chiffrement.

uPhyId

Identificateur (ID) d’un type PHY sur la station 802.11. La station 802.11 doit utiliser le PHY spécifié pour transmettre le paquet.

La valeur de uPhyId doit être l’une des suivantes :

Valeur d’une entrée dans la liste des types PHY actifs définis par l’objet msDot11ActivePhyList objet MIB. Le pilote miniport définit cet objet MIB sur la liste des PHY qui ont été activés pour une utilisation via la connexion réseau BSS (Basic Service Set) actuelle. Pour plus d’informations sur l’objet msDot11ActivePhyList MIB, consultez OID_DOT11_ACTIVE_PHY_LIST.
Valeur de DOT11_PHY_ID_ANY, auquel cas la station 802.11 peut utiliser n’importe quel PHY dans la liste des PHY actives définies par l’objet msDot11ActivePhyList MIB.

Le pilote miniport doit échouer la demande d’envoi si le PHY spécifié par uPhyId n’est pas pris en charge ou a été désactivé par le biais d’un mécanisme propriétaire implémenté par le fournisseur de matériel indépendant (IHV). Dans ce cas, le pilote miniport définit le membre Status de la structure de NET_BUFFER_LIST sur NDIS_STATUS_UNSUPPORTED_MEDIA et les appels NdisMSendNetBufferListsComplete pour terminer la demande d’envoi.

uDelayedSleepValue

Temps, en microsecondes, avant qu’une réponse au paquet soit attendue. Le membre uDelayedSleepValue n’est valide que lorsque toutes les valeurs suivantes sont remplies :

Le paquet est un paquet MSDU (Media Access Control) de service (MAC).
La station 802.11 fonctionne en mode d’économie d’alimentation (PS). Dans ce cas, l’objet msDot11PowerSavingLevel base d’informations de gestion (MIB) de la station extensible (ExtSTA) a n’importe quelle valeur, sauf DOT11_POWER_SAVING_NO_POWER_SAVING. Pour plus d’informations sur la valeur msDot11PowerSavingLevel MIB, consultez OID_DOT11_POWER_MGMT_REQUEST.

La station 802.11 utilise la valeur de uDelayedSleepValue pour optimiser les performances du réseau tout en fonctionnant en mode PS. Par exemple, selon le mode PS, la station 802.11 peut conserver la radio activée après la transmission du paquet si uDelayedSleepValue est faible. Ainsi, la latence du réseau sera réduite pour recevoir la réponse.

pvMediaSpecificInfo

Pointeur vers une mémoire tampon qui contient des informations spécifiques au support. Ce membre doit être NULL lorsque la structure de NET_BUFFER_LIST 802.11 associée provient de l’infrastructure native 802.11 elle-même (y compris les structures NET_BUFFER_LIST provenant d’une extension IHV).

Sinon, pvMediaSpecificInfo pointe vers les données hors bande (OOB) associées à l’entrée MediaSpecificInformation à l’entrée NetBufferListInfo membre de la structure de NET_BUFFER_LIST d’origine 802.3. pvMediaSpecificInfo permet au pilote miniport d’accéder aux informations spécifiques aux médias à partir d’un pilote de protocole 802.3 spécifique à IHV.

uSendFlags

Ensemble d’indicateurs qui définissent les attributs d’envoi. Actuellement, aucun indicateur n’est défini. Ce membre doit être égal à zéro.

Remarques

Le pilote miniport effectue une opération d’envoi quand il MiniportSendNetBufferLists est appelée. Chaque paquet transmis au pilote via cette fonction est défini par une structure NET_BUFFER_LIST, qui contient des données OOB (out-of-band) natives 802.11. Les données OOB contiennent des paramètres spécifiques aux médias utilisés par la station 802.11 lors de la transmission du paquet.

Le pilote miniport accède aux données OOB natives 802.11 via la macro NET_BUFFER_LIST_INFO avec les paramètres suivants :

Paramètre _NBL, qui est passé le pointeur à la structure NET_BUFFER_LIST utilisée pour le paquet 802.11 reçu.
Paramètre _ id, qui est passé la valeur d’identificateur (ID) de MediaSpecificInformation.

Pour plus d’informations sur les opérations d’envoi natives 802.11, consultez Opérations d’envoi natives 802.11.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête	windot11.h (include Ndis.h)