structure DOT11_EXTSTA_SEND_CONTEXT (windot11.h)

Article
08/08/2023

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La structure DOT11_EXTSTA_SEND_CONTEXT définit les attributs natifs 802.11 d’un paquet à envoyer par le pilote miniport fonctionnant en mode ExtSTA (Extensible Station). Pour plus d’informations sur ce mode de fonctionnement, consultez Mode de fonctionnement de la 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 Header 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é des opérations de chiffrement effectuées par la station 802.11.

DOT11_EXEMPT_ALWAYS

Le paquet est exempté des 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 ne dispose pas d’une 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 Types de clés de chiffrement 802.11.

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 MIB msDot11ActivePhyList . Le pilote miniport définit cet objet MIB sur la liste des phYs qui ont été activés pour une utilisation sur la connexion réseau BSS (Basic Service Set) actuelle. Pour plus d’informations sur l’objet MIB msDot11ActivePhyList , consultez OID_DOT11_ACTIVE_PHY_LIST.
Valeur de DOT11_PHY_ID_ANY, auquel cas la station 802.11 peut utiliser n’importe quel PHY de la liste des PHY actives définie par l’objet MIB msDot11ActivePhyList .

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é via 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 NET_BUFFER_LIST sur NDIS_STATUS_UNSUPPORTED_MEDIA et appelle 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 si toutes les conditions suivantes sont remplies :

Le paquet est un paquet MSDU (Media Access Control).
La station 802.11 fonctionne en mode économie d’énergie (PS). Dans ce cas, l’objet MIB (Extensible Station) msDot11PowerSavingLevel n’a aucune valeur, sauf DOT11_POWER_SAVING_NO_POWER_SAVING. Pour plus d’informations sur la valeur MIB msDot11PowerSavingLevel , consultez OID_DOT11_POWER_MGMT_REQUEST.

La station 802.11 utilise la valeur uDelayedSleepValue pour optimiser les performances réseau en mode PS. Par exemple, selon le mode PS, la station 802.11 peut maintenir la radio activée après la transmission du paquet si uDelayedSleepValue est petit. Ce faisant, la latence réseau sera réduite pour la réception de la réponse.

pvMediaSpecificInfo

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

Sinon, pvMediaSpecificInfo pointe vers les données hors bande (OOB) associées à l’entrée MediaSpecificInformation au membre NetBufferListInfo de la structure 802.3 NET_BUFFER_LIST d’origine. pvMediaSpecificInfo permet au pilote miniport d’accéder aux informations spécifiques au média à 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 lorsque son MiniportSendNetBufferLists est appelé. Chaque paquet transmis au pilote via cette fonction est défini par une structure NET_BUFFER_LIST , qui contient des données natives 802.11 hors bande (OOB). Les données OOB contiennent des paramètres spécifiques au média que la station 802.11 utilise lors de la transmission du paquet.

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

Paramètre _NBL , qui est passé le pointeur vers 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête	windot11.h (inclure Ndis.h)