Partager via


structure DOT11_PEER_INFO (windot11.h)

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.
 
La structure DOT11_PEER_INFO spécifie des informations sur une station homologue au sein d’un réseau IBSS (Jeu de services de base) indépendant.
Note IBSS (ad hoc) et SoftAP sont déconseillés. En commençant par Windows 8.1 et Windows Server 2012 R2, utilisez Wi-Fi Direct.
 

Syntaxe

typedef struct _DOT11_PEER_INFO {
  DOT11_MAC_ADDRESS       MacAddress;
  USHORT                  usCapabilityInformation;
  DOT11_AUTH_ALGORITHM    AuthAlgo;
  DOT11_CIPHER_ALGORITHM  UnicastCipherAlgo;
  DOT11_CIPHER_ALGORITHM  MulticastCipherAlgo;
  BOOLEAN                 bWpsEnabled;
  USHORT                  usListenInterval;
  UCHAR                   ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2];
  USHORT                  usAssociationID;
  DOT11_ASSOCIATION_STATE AssociationState;
  DOT11_POWER_MODE        PowerMode;
  LARGE_INTEGER           liAssociationUpTime;
  DOT11_PEER_STATISTICS   Statistics;
} DOT11_PEER_INFO, *PDOT11_PEER_INFO;

Membres

MacAddress

Adresse MAC (Media Access Control) de la station homologue au sein d’un réseau BSS (IBSS) indépendant.

usCapabilityInformation

Champ d’informations sur la capacité 802.11 de la balise ou des trames de réponse de sonde que la station 802.11 a récemment reçues de l’homologue.

AuthAlgo

Algorithme d’authentification que la station 802.11 a résolu avec la station homologue pendant l’opération d’association. Pour plus d’informations sur le type de données du membre AuthAlgo , consultez DOT11_AUTH_ALGORITHM.

Ce membre n’est pas défini si l’homologue n’est pas associé.

UnicastCipherAlgo

Algorithme de chiffrement de monodiffusion que la station 802.11 a résolu avec la station homologue pendant l’opération d’association. Pour plus d’informations sur le type de données du membre UnicastCipherAlgo , consultez DOT11_CIPHER_ALGORITHM.

Ce membre n’est pas défini si l’homologue n’est pas associé.

MulticastCipherAlgo

Algorithme de chiffrement de multidiffusion que la station 802.11 a résolu avec la station homologue pendant l’opération d’association. Pour plus d’informations sur le type de données du membre MulticastCipherAlgo , consultez DOT11_CIPHER_ALGORITHM.

Ce membre n’est pas défini si l’homologue n’est pas associé.

bWpsEnabled

Valeur booléenne qui indique si le programme d’installation protégée par Wi-Fi (WPS) est activé pour la station homologue. Si la valeur est TRUE, WPS est activé et les algorithmes d’authentification et de chiffrement utilisés par l’homologue peuvent être différents des algorithmes activés sur l’AP.

Ce membre ne doit pas être utilisé si l’homologue n’est pas associé.

usListenInterval

Valeur USHORT qui définit le champ Intervalle d’écoute 802.11 obtenu à partir de la demande d’association.

Ce membre a la valeur zéro si l’homologue n’est pas associé.

ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2]

Valeur UCHAR qui spécifie les débits de données pris en charge par la station homologue. Ces taux sont basés sur les taux 802.11 Pris en charge IE à partir des trames de réponse de balise ou de sonde que la station 802.11 a récemment reçues de l’homologue.

Chaque entrée du tableau ucPeerSupportedRates est la valeur d’un index dans la table des débits de données retournés par le biais d’une requête de OID_DOT11_DATA_RATE_MAPPING_TABLE. La valeur d’index doit être comprise entre 2 et 127.

Ce membre a la valeur zéro si l’homologue n’est pas associé.

usAssociationID

Valeur USHORT qui spécifie le champ ID d’association 802.11 à partir des trames de réponse d’association ou de ré-association que la station 802.11 a reçues de l’AP.

Ce membre a la valeur 0xFFFF si l’homologue n’est pas associé.

AssociationState

Valeur de type DOT11_ASSOCIATION_STATE qui indique l’état d’authentification et d’association 802.11 de la station homologue. L’état peut être dot11_assoc_state_auth_unassoc ou dot11_assoc_state_auth_assoc.

Dans la norme IEEE 802.11, la procédure d’authentification 802.11 est facultative pour un réseau indépendant. Par conséquent, selon l’implémentation IHV, l’état représenté par la valeur d’énumération dot11_assoc_state_auth_unassoc peut ne pas être applicable.

PowerMode

Valeur de type DOT11_POWER_MODE qui décrit le mode de gestion de l’alimentation le plus récent de la station homologue.

liAssociationUpTime

Valeur LARGEINTEGER qui spécifie l’horodatage lorsque la procédure d’association 802.11 s’est terminée avec succès. Le pilote miniport appelle NdisGetCurrentSystemTime pour obtenir l’horodatage de l’achèvement de l’association.

Ce membre a la valeur zéro si l’homologue n’est pas associé.

Statistics

Compteurs de statistiques pour le trafic de données, définis par la structure DOT11_PEER_STATISTICS .

Ce membre a la valeur zéro si l’homologue n’est pas associé.

Configuration requise

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

Voir aussi

DOT11_POWER_MODE

DOT11_ASSOCIATION_STATE

NdisGetCurrentSystemTime

DOT11_PEER_STATISTICS

DOT11_PEER_INFO_LIST

NDIS_OBJECT_HEADER