struttura DOT11_PEER_INFO (windot11.h)

Articolo
02/07/2025

Importante

WiFiCx è il nuovo modello di driver Wi-Fi rilasciato in Windows 11. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti. Il modello di driver WDI è ora in modalità di manutenzione e riceverà solo correzioni ad alta priorità.

La struttura DOT11_PEER_INFO specifica informazioni su una stazione peer all'interno di una rete IBSS (Basic Service Set) indipendente.

Nota IBSS (ad hoc) e SoftAP sono deprecati. A partire da Windows 8.1 e Windows Server 2012 R2, usare Wi-Fi Direct.

Sintassi

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;

Membri

MacAddress

Indirizzo MAC (Media Access Control) della stazione peer all'interno di una rete IBSS (Independent BSS).

usCapabilityInformation

Il campo 802.11 Capability Information dai frame di risposta del beacon o probe ricevuti più di recente dalla stazione 802.11 dal peer.

AuthAlgo

Algoritmo di autenticazione 802.11 risolto con la stazione peer durante l'operazione di associazione. Per altre informazioni sul tipo di dati per il membro AuthAlgo, vedere DOT11_AUTH_ALGORITHM.

Questo membro non è definito se il peer non è associato.

UnicastCipherAlgo

Algoritmo di crittografia unicast risolto dalla stazione 802.11 con la stazione peer durante l'operazione di associazione. Per altre informazioni sul tipo di dati per il membro unicastCipherAlgo, vedere DOT11_CIPHER_ALGORITHM.

Questo membro non è definito se il peer non è associato.

MulticastCipherAlgo

Algoritmo di crittografia multicast risolto dalla stazione 802.11 con la stazione peer durante l'operazione di associazione. Per altre informazioni sul tipo di dati per il membro MulticastCipherAlgo, vedere DOT11_CIPHER_ALGORITHM.

Questo membro non è definito se il peer non è associato.

bWpsEnabled

Valore booleano che indica se l'installazione wi-fi protetta (WPS) è abilitata per la stazione peer. Se TRUE, WPS è abilitato e gli algoritmi di autenticazione e crittografia usati dal peer potrebbero essere diversi dagli algoritmi abilitati nell'API.

Questo membro non deve essere utilizzato se il peer non è associato.

usListenInterval

Valore USHORT che definisce il campo Intervallo di ascolto 802.11 ottenuto dalla richiesta di associazione.

Questo membro ha un valore pari a zero se il peer non è associato.

ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2]

Valore UCHAR che specifica le tariffe dei dati supportate dalla stazione peer. Queste tariffe si basano sulla frequenza di internet explorer 802.11 supportata dai frame di risposta beacon o probe ricevuti più di recente dalla stazione 802.11 dal peer.

Ogni voce nella matrice ucPeerSupportedRates è il valore di un indice all'interno della tabella delle frequenze di dati restituite tramite una query di OID_DOT11_DATA_RATE_MAPPING_TABLE. Il valore dell'indice deve essere compreso tra 2 e 127.

Questo membro ha un valore pari a zero se il peer non è associato.

usAssociationID

Valore USHORT che specifica il campo ID associazione 802.11 dai frame di risposta di associazione o di ri associazione ricevuti dalla stazione 802.11 dall'AP.

Questo membro ha un valore di 0xFFFF se il peer non è associato.

AssociationState

Valore DOT11_ASSOCIATION_STATE-type che indica lo stato di autenticazione e associazione 802.11 della stazione peer. Lo stato può essere dot11_assoc_state_auth_unassoc o dot11_assoc_state_auth_assoc.

Nella IEEE 802.11 Standard, la procedura di autenticazione 802.11 è facoltativa per una rete indipendente. Pertanto, a seconda dell'implementazione IHV, lo stato rappresentato dal valore di enumerazione dot11_assoc_state_auth_unassoc potrebbe non essere applicabile.

PowerMode

Valore DOT11_POWER_MODE-type che descrive la modalità di risparmio energia più recente della stazione peer.

liAssociationUpTime

Valore LARGEINTEGER che specifica il timestamp al completamento della procedura di associazione 802.11. Il driver miniport chiama NdisGetCurrentSystemTime per ottenere il timestamp del completamento dell'associazione.

Questo membro ha un valore pari a zero se il peer non è associato.

Statistics

Contatori delle statistiche per il traffico di dati, definito dalla struttura DOT11_PEER_STATISTICS.

Questo membro ha un valore pari a zero se il peer non è associato.