structure DOT11_EXTSTA_SEND_CONTEXT (windot11.h)
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 .
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.
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.
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) |