structure DOT11_BSS_ENTRY (windot11.h)
Syntaxe
typedef struct DOT11_BSS_ENTRY {
ULONG uPhyId;
DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_BSS_TYPE dot11BSSType;
LONG lRSSI;
ULONG uLinkQuality;
BOOLEAN bInRegDomain;
USHORT usBeaconPeriod;
ULONGLONG ullTimestamp;
ULONGLONG ullHostTimestamp;
USHORT usCapabilityInformation;
ULONG uBufferLength;
UCHAR ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;
Membres
uPhyId
Identificateur (ID) du PHY utilisé par la station 802.11 pour détecter le réseau BSS. L’ID PHY est l’index dans la liste des PHYs pris en charge retournés par le pilote via une requête de OID_DOT11_SUPPORTED_PHY_TYPES.
Cet ID ne doit pas être DOT11_PHY_ID_ANY.
PhySpecificInfo
Attributs du PHY référencé par le membre uPhyId . PhySpecificInfo est mis en forme en tant que DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO union.
dot11BSSID
Adresse MAC (Media Access Control) du point d’accès (AP) (pour les réseaux BSS d’infrastructure) ou d’une station homologue (pour les réseaux BSS indépendants) qui a envoyé la trame de réponse 802.11 Beacon ou Probe reçue par la station 802.11 lors de l’analyse. Le type de données de ce membre est la structure DOT11_MAC_ADDRESS .
dot11BSSType
Type de réseau BSS.
Le type de données de ce membre est l’énumération DOT11_BSS_TYPE . Le pilote miniport ne doit pas définir ce membre sur la valeur dot11_BSS_type_any .
lRSSI
Valeur d’indicateur de puissance du signal (RSSI) reçue, en unités de décibels référencées à 1,0 milliwatts (sgbd), comme détecté par la station 802.11 pour la station AP ou pair.
uLinkQuality
Valeur de qualité du lien comprise entre 0 et 100. La valeur 100 spécifie la qualité de lien la plus élevée. Pour plus d’informations sur la détermination de la qualité des liens, consultez Opérations de qualité des liens.
bInRegDomain
Ce membre spécifie si l’AP ou la station homologue fonctionne dans le domaine réglementaire comme identifié par la chaîne de pays d’entrée. Pour définir ce membre, le pilote miniport doit utiliser les instructions suivantes :
- Si la station 802.11 ne prend pas en charge plusieurs domaines réglementaires, définissez le membre sur TRUE. Pour plus d’informations sur plusieurs domaines réglementaires, consultez OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
- Si la chaîne de pays d’entrée est toutes zéros, définissez le membre sur TRUE.
- Si l’AP ou la station homologue ne fonctionne pas sur un canal valide pour le domaine réglementaire spécifié par la chaîne de pays d’entrée, définissez le membre sur FALSE.
-
Si la trame de réponse 802.11 Beacon ou Probe, qui a été reçue à partir de l’AP ou de la station homologue, n’inclut pas d’élément d’information Country (IE), définissez le membre sur TRUE.
Pour plus d’informations sur country IE, reportez-vous à la clause 7.3.2.12 de la norme IEEE 802.11d-2001.
- Si le cadre de réponse de 802.11 Beacon ou Probe, qui a été reçu à partir de la station AP ou peer, inclut un Country IE, définissez le membre sur FALSE si la valeur du sous-champ Chaîne de pays n’est pas égale à la chaîne de pays d’entrée.
- Définissez le membre sur TRUE dans tous les autres cas.
usBeaconPeriod
Valeur du champ Intervalle de balise à partir du cadre de réponse de la balise 802.11 Beacon ou Probe Response Frame.
ullTimestamp
Valeur du champ Timestamp de la trame réponse de 802.11 Beacon ou Probe.
ullHostTimestamp
Horodatage, résolu par un appel à NdisGetCurrentSystemTime, qui enregistre le moment où la station 802.11 a reçu la trame de réponse de 802.11 Beacon ou Probe.
usCapabilityInformation
Valeur du champ Informations sur la capacité à partir du cadre de réponse de la balise 802.11 ou de la sonde.
uBufferLength
Longueur, en octets, du tableau ucBuffer dans la structure DOT11_BSS_ENTRY. ulBufferLength doit être la longueur exacte des données dans le tableau ucBuffer et ne doit contenir aucun remplissage pour l’alignement.
ucBuffer[1]
Éléments d’informations de longueur variable (EE) des trames de réponse de 802.11 Beacon ou Probe. Pour chaque BSS, les EE doivent provenir de la dernière trame de réponse de beacon ou de sonde reçue de ce réseau BSS. Si un IE n’est disponible que dans une seule image, le pilote miniport doit fusionner l’IE avec les autres E/S de la dernière trame de réponse beacon ou de sonde reçue.
Lorsque la carte réseau est en mode OP Extensible Access Point (ExtAP), la liste BSS doit contenir une entrée pour la carte réseau BSS créée.
Pour plus d’informations sur les champs de la norme IEEE 802.11 Beacon ou Probe Response frames, reportez-vous à la clause 8.4 de la norme IEEE 802.11-2012.
Remarques
Lorsque la station 802.11 effectue une opération d’analyse, le pilote miniport Native 802.11 met en cache les images de réponse de 802.11 beacon et de réponse de sonde reçues. Pour plus d’informations sur l’opération d’analyse, consultez Opérations d’analyse natives 802.11.
Une fois la station 802.11 terminée l’opération d’analyse, le pilote miniport retourne la liste des trames de réponse beacon et de sonde mises en cache lors de l’interrogation par OID_DOT11_ENUM_BSS_LIST. Une structure de DOT11_BSS_ENTRY distincte est mise en forme pour chaque trame de réponse de beacon et de sonde.
Spécifications
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| En-tête | windot11.h (inclure Ndis.h) |