DOT11_PEER_INFO struttura (windot11.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless nativa 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver windows universale WLAN.

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

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;

Members

MacAddress

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

usCapabilityInformation

Il campo Informazioni sulle funzionalità 802.11 dai frame di risposta di 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 protetta WiFi (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'AP.

Questo membro non deve essere usato 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 sui fotogrammi di risposta supportati 802.11 dai frame di risposta di beacon o probe ricevuti più di recente dalla stazione 802.11.

Ogni voce nella matrice ucPeerSupportedRates è il valore di un indice all'interno della tabella delle tariffe dei 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 dall'associazione o ri-associazione dei frame di risposta 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.

Nello standard IEEE 802.11, 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 di DOT11_POWER_MODE che descrive la modalità di risparmio energia più recente della stazione peer.

liAssociationUpTime

Valore LARGEINTEGER che specifica il timestamp al termine 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

I contatori delle statistiche per il traffico dati, definiti dalla struttura DOT11_PEER_STATISTICS .

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