structure DOT11_PEER_INFO (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_PEER_INFO spécifie des informations sur une station d’homologue au sein d’un réseau IBSS (Basic Service Set) indépendant.
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 d’homologue au sein d’un réseau BSS (IBSS) indépendant.
usCapabilityInformation
Champ d’informations sur les capacités 802.11 à partir des trames de réponse de la balise ou de la sonde que la station 802.11 a récemment reçue de l’homologue.
AuthAlgo
Algorithme d’authentification résolu par la station 802.11 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 unicast résolu par la station 802.11 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 multidiffusion résolu par la station 802.11 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 wpS (WiFi Protected Setup) est activé pour la station homologue. Si 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’API.
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 taux de données pris en charge par la station homologue. Ces taux sont basés sur les 802,11 taux pris en charge IE à partir de la balise ou des trames de réponse de sonde que la station 802.11 a récemment reçue de l’homologue.
Chaque entrée dans le tableau ucPeerSupportedRates est la valeur d’un index dans la table des taux de données retournés via 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 de l’association ou des trames de réponse de réinscrire que la station 802.11 a reçue de l’AP.
Ce membre a la valeur 0xFFFF si l’homologue n’est pas associé.
AssociationState
Valeur DOT11_ASSOCIATION_STATE-type qui indique l’authentification 802.11 et l’état d’association de la station homologue. L’état peut être dot11_assoc_state_auth_unassoc ou dot11_assoc_state_auth_assoc.
Dans la IEEE 802.11 Standard, 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 DOT11_POWER_MODE-type qui décrit le dernier mode de gestion de l’alimentation de la station homologue.
liAssociationUpTime
Valeur LARGEINTEGER qui spécifie l’horodatage lorsque la procédure d’association 802.11 a réussi. 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é.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | windot11.h (include Ndis.h) |