structure DOT11_BSS_ENTRY (windot11.h)

Article
03/01/2024

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_BSS_ENTRY définit une balise IEEE 802.11 ou un cadre de réponse que la station 802.11 a reçu lors de 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 PHY prises en charge retournées 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és par le membre uPhyId . PhySpecificInfo est mis en forme en tant que DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO union.

dot11BSSID

Adresse de contrôle d’accès multimédia (MAC) du point d’accès (AP) (pour les réseaux BSS d’infrastructure) ou de la station homologue (pour les réseaux BSS indépendants) qui a envoyé la balise 802.11 ou le cadre de réponse de sonde reçu 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 d’intensité du signal (RSSI) reçue, en unités de décibels référencées à 1,0 milliwatts (dBm), comme détecté par la station 802.11 pour le point d’accès ou la station homologue.

uLinkQuality

Valeur de qualité de lien comprise entre 0 et 100. La valeur 100 spécifie la qualité de liaison 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 d’homologue fonctionne dans le domaine réglementaire 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 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 à la balise ou à la sonde 802.11, qui a été reçue 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 à la balise ou à la sonde 802.11, qui a été reçu de l’AP ou de la station homologue, inclut un IE de pays, définissez le membre sur FALSE si la valeur du sous-champ Country String 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 du cadre 802.11 Beacon or Probe Response.

ullTimestamp

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

ullHostTimestamp

Horodatage, résolu par un appel à NdisGetCurrentSystemTime, qui enregistre quand la station 802.11 a reçu le cadre de réponse beacon ou sonde 802.11.

usCapabilityInformation

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

uBufferLength

Longueur, en octets, du tableau ucBuffer dans la structure DOT11_BSS_ENTRY. ulBufferLength doit correspondre à la longueur exacte des données du tableau ucBuffer et ne doit pas contenir de remplissage pour l’alignement.

ucBuffer[1]

Éléments d’informations de longueur variable (EE) des trames de réponse de balise ou de sonde 802.11. Pour chaque BSS, les EE doivent provenir de la dernière trame de réponse de balise 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 EE de la dernière balise ou du dernier frame de réponse de sonde reçu.

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

Pour plus d’informations sur les champs dans les trames de balise ou de réponse de sonde IEEE 802.11, 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 trames de réponse de balise et de sonde 802.11 reçues. Pour plus d’informations sur l’opération d’analyse, consultez Opérations d’analyse natives 802.11.

Une fois que la station 802.11 a terminé l’opération d’analyse, le pilote miniport retourne la liste des images de réponse de balise et de sonde mises en cache lorsqu’elle est interrogée par OID_DOT11_ENUM_BSS_LIST. Une structure DOT11_BSS_ENTRY distincte est mise en forme pour chaque trame de réponse de balise et de sonde.

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)