Partager via


structure DOT11_BSS_ENTRY (windot11.h)

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_BSS_ENTRY définit une balise IEEE 802.11 Beacon ou Response Frame que la station 802.11 a reçue pendant sa dernière opération d’analyse.

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 comme un 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 de la station d’homologue (pour les réseaux BSS indépendants) qui a envoyé la trame de réponse de 802.11 Beacon ou Sonde 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 de l’indicateur de force du signal reçu (RSSI), en unités de décbels référencées à 1,0 milliwatts (dBm), comme détecté par la station 802.11 pour la station AP ou pair.

uLinkQuality

Valeur de qualité de 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 tel qu’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 les zéros, définissez le membre sur TRUE.
  • Si l’AP ou la station d’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 de 802.11 Beacon ou sonde, qui a été reçue à partir de la station AP ou pair, n’inclut pas d’élément d’informations 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 sonde, qui a été reçu de la station AP ou pair, 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 beacon à partir du cadre de réponse de la balise 802.11 Beacon ou de la sonde.

ullTimestamp

Valeur du champ Timestamp à partir du cadre de réponse de la balise 802.11 ou de la sonde.

ullHostTimestamp

L’horodatage, résolu par le biais d’un appel à NdisGetCurrentSystemTime, qui enregistre lorsque la station 802.11 a reçu la trame de réponse de 802.11 Beacon ou Sonde.

usCapabilityInformation

Valeur du champ Informations sur la capacité du cadre de réponse de la sonde ou de la balise 802.11.

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 images de réponse de 802.11 Beacon ou De sonde. Pour chaque BSS, les EE doivent provenir du dernier cadre de réponse de la balise ou de la sonde reçu de ce réseau BSS. Si un IE n’est disponible que dans un seul frame, le pilote miniport doit fusionner l’IE avec les autres E/S de la dernière trame de réponse de sonde ou de beacon reçue.

Lorsque la carte réseau se trouve en mode OP De point d’accès extensible (ExtAP), la liste BSS doit contenir une entrée pour le service BSS créé par la carte réseau.

Pour plus d’informations sur les champs de l’IEEE 802.11 Beacon ou des trames de réponse de sonde, 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 Natif 802.11 met en cache les images de réponse de 802.11 Beacon et 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.

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)

Voir aussi

DOT11_BSS_TYPE

DOT11_BSS_LIST

OID_DOT11_SUPPORTED_PHY_TYPES

OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED

DOT11_MAC_ADDRESS

DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO

NdisGetCurrentSystemTime

OID_DOT11_ENUM_BSS_LIST