struttura DOT11_EXTSTA_ATTRIBUTES (windot11.h)
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_EXTSTA_ATTRIBUTES definisce gli attributi fisici e operativi del driver miniport e della stazione 802.11 quando opera in modalità Extensible Station (ExtSTA). Per altre informazioni su questa modalità operativa, vedere Extensible Station Operation Mode.
Sintassi
typedef struct DOT11_EXTSTA_ATTRIBUTES {
NDIS_OBJECT_HEADER Header;
ULONG uScanSSIDListSize;
ULONG uDesiredBSSIDListSize;
ULONG uDesiredSSIDListSize;
ULONG uExcludedMacAddressListSize;
ULONG uPrivacyExemptionListSize;
ULONG uKeyMappingTableSize;
ULONG uDefaultKeyTableSize;
ULONG uWEPKeyValueMaxLength;
ULONG uPMKIDCacheSize;
ULONG uMaxNumPerSTADefaultKeyTables;
BOOLEAN bStrictlyOrderedServiceClassImplemented;
UCHAR ucSupportedQoSProtocolFlags;
BOOLEAN bSafeModeImplemented;
ULONG uNumSupportedCountryOrRegionStrings;
PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
ULONG uInfraNumSupportedUcastAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pInfraSupportedUcastAlgoPairs;
ULONG uInfraNumSupportedMcastAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pInfraSupportedMcastAlgoPairs;
ULONG uAdhocNumSupportedUcastAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pAdhocSupportedUcastAlgoPairs;
ULONG uAdhocNumSupportedMcastAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pAdhocSupportedMcastAlgoPairs;
BOOLEAN bAutoPowerSaveMode;
ULONG uMaxNetworkOffloadListSize;
BOOLEAN bMFPCapable;
ULONG uInfraNumSupportedMcastMgmtAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pInfraSupportedMcastMgmtAlgoPairs;
} DOT11_EXTSTA_ATTRIBUTES, *PDOT11_EXTSTA_ATTRIBUTES;
Membri
Header
Tipo, revisione e dimensione della struttura DOT11_EXTSTA_ATTRIBUTES. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER.
Il driver miniport deve impostare i membri di Header sui valori seguenti.
Digitare
Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.
Revisione
Questo membro deve essere impostato su uno dei valori seguenti in base al sistema operativo in cui deve essere eseguito il driver:
DOT11_EXTSTA_ATTRIBUTES_REVISION_1
Windows Vista
DOT11_EXTSTA_ATTRIBUTES_REVISION_2
Windows Vista con Service Pack 1 (SP1) o versioni successive dei sistemi operativi Windows
DOT11_EXTSTA_ATTRIBUTES_REVISION_3
Windows 8 o versioni successive dei sistemi operativi Windows
Questi valori determinano come il sistema operativo interpreta il membro bSafeModeImplemented.
Grandezza
Questo membro deve essere impostato su sizeof(DOT11_EXTSTA_ATTRIBUTES).
Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.
uScanSSIDListSize
Numero massimo di identificatori del set di servizi (SSID) supportati dalla stazione 802.11 per le operazioni di analisi. La stazione 802.11 deve supportare un elenco SSID di almeno quattro voci.
L'elenco SSID utilizzato dalla stazione 802.11 per l'analisi viene specificato quando viene impostato OID_DOT11_SCAN_REQUEST.
uDesiredBSSIDListSize
Numero massimo di voci nell'elenco desiderato di identificatori di set di servizi di base (BSSID) supportati dalla stazione 802.11. La stazione 802.11 deve supportare un elenco BSSID con almeno una voce.
Per altre informazioni sull'elenco BSSID desiderato, vedere OID_DOT11_DESIRED_BSSID_LIST.
uDesiredSSIDListSize
Numero massimo di voci nell'elenco SSID desiderato supportato dalla stazione 802.11. La stazione 802.11 deve supportare un elenco SSID desiderato con almeno una voce.
Per altre informazioni sull'elenco SSID desiderato, vedere OID_DOT11_DESIRED_SSID_LIST.
uExcludedMacAddressListSize
Numero massimo di voci nell'elenco indirizzi MAC escluso supportato dalla stazione 802.11. La stazione 802.11 deve supportare un elenco indirizzi MAC escluso con almeno quattro voci.
Per altre informazioni sull'elenco di indirizzi MAC esclusi desiderato, vedere OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.
uPrivacyExemptionListSize
Numero massimo di voci nell'elenco di esenzione della privacy supportato dalla stazione 802.11. La stazione 802.11 deve supportare un elenco di esenzione per la privacy con almeno una voce.
Per altre informazioni sull'elenco delle esenzioni per la privacy, vedere OID_DOT11_PRIVACY_EXEMPTION_LIST.
uKeyMappingTableSize
Numero massimo di chiavi di mapping delle chiavi di crittografia supportate dalla stazione 802.11. È consigliabile che la stazione 802.11 supporti almeno 32 tasti di mapping delle chiavi.
Per altre informazioni sulle chiavi di mapping delle chiavi, vedere OID_DOT11_CIPHER_KEY_MAPPING_KEY.
uDefaultKeyTableSize
Il numero massimo di chiavi di crittografia supportate dalla stazione 802.11 per le tabelle chiave predefinite e predefinite per stazione.
Per gli algoritmi di crittografia standard 802.11, la stazione 802.11 deve supportare almeno quattro chiavi di crittografia. Per gli algoritmi di crittografia sviluppati dal fornitore di hardware indipendente (IHV), le dimensioni della tabella possono essere quattro o superiori.
uWEPKeyValueMaxLength
Lunghezza massima, in byte, di una chiave di crittografia WEP supportata dalla stazione 802.11.
Nella tabella seguente sono elencate le lunghezze di chiave minima e massima, in byte, per i vari valori di crittografia WEP definiti tramite DOT11_CIPHER_ALGORITHM.
| Crittografia WEP | Lunghezza minima chiave | Lunghezza massima della chiave |
|---|---|---|
| DOT11_CIPHER_ALGO_WEP40 | 5 | 5 |
| DOT11_CIPHER_ALGO_WEP104 | 13 | 13 |
| DOT11_CIPHER_ALGO_WEP | 13 | Qualsiasi lunghezza supportata dalla stazione 802.11 |
uPMKIDCacheSize
Numero massimo di voci nella cache PMKID (Pairwise Master Key Identifier) supportata dalla stazione 802.11.
Se la stazione 802.11 non supporta una cache PMKID, il driver miniport deve impostare questo membro su zero. In caso contrario, la stazione 802.11 deve supportare una dimensione della cache PMKID di almeno tre voci.
Per altre informazioni sulla cache PMKID, vedere OID_DOT11_PMKID_LIST.
uMaxNumPerSTADefaultKeyTables
Numero massimo di tabelle chiave di crittografia predefinite per stazione supportate dalla stazione 802.11. È consigliabile che la stazione 802.11 supporti almeno 32 tabelle chiave di crittografia predefinite per stazione.
Per altre informazioni sulle tabelle chiave di crittografia predefinite per stazione, vedere Per-Station Chiavi predefinite.
bStrictlyOrderedServiceClassImplemented
Valore booleano che, se impostato su TRUE, specifica che la stazione 802.11 supporta la classe di servizio IEEE 802.11 StrictlyOrdered per il recapito di pacchetti MSDU (Media Access Control).
Per altre informazioni sulla classe di servizio StrictlyOrdered, vedere clausola 5.1.3 dello standard IEEE 802.11-2012.
ucSupportedQoSProtocolFlags
Set di flag che specificano i protocolli QoS (Quality of Service) implementati dalla scheda di interfaccia di rete. Questo membro è zero o una combinazione OR bit per bit dei flag seguenti:
DOT11_QOS_PROTOCOL_FLAG_WMM
La scheda di interfaccia di rete implementa il protocollo QoS WMM 802.11.
DOT11_QOS_PROTOCOL_FLAG_11E
La scheda di interfaccia di rete implementa il protocollo QoS 802.11e.
bSafeModeImplemented
La funzionalità di supporto della modalità provvisoria della combinazione di driver NIC/miniport. Il sistema operativo interpreta questo membro in modo diverso a seconda del valore di Header.Revision:
Revisione = DOT11_EXTSTA_ATTRIBUTES_REVISION_1
Il sistema operativo interpreta il membro bSafeModeImplemented come valore booleano. Se questo valore è TRUE, la scheda di interfaccia di rete implementa la modalità provvisoria 802.11 dell'operazione. In caso contrario, il valore è FALSE.
Revisione = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 o versione successiva
Il sistema operativo interpreta il membro bSafeModeImplemented come campo di bit con i valori di bit possibili impostati:
- Se il campo di bit è impostato su DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED senza altri bit impostati, il driver miniport implementa la modalità provvisoria 802.11.
- Se il campo di bit è impostato su DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED, la combinazione NIC/miniport ha ricevuto un certificato di convalida dal National Institute of Standards and Technology (NIST) in Federal Information Processing Standards (FIPS) Publication 140-2, Security Requirements for Cryptographic Modules.
uNumSupportedCountryOrRegionStrings
Numero di stringhe di paese o area geografica supportate dalla stazione 802.11. Se la stazione 802.11 supporta più domini normativi come specificato dallo standard IEEE 802.11d-2001, ogni stringa di paese o area geografica identifica un dominio normativo supportato dalla stazione 802.11.
Se la stazione 802.11 non supporta lo standard IEEE 802.11d-2001, il driver miniport deve impostare uNumSupportedCountryOrRegionStrings su zero.
pSupportedCountryOrRegionStrings
Puntatore a una matrice di stringhe di paese o area geografica 802.11d supportate dalla stazione 802.11. Ogni voce della matrice è formattata come DOT11_COUNTRY_OR_REGION_STRING struttura.
uInfraNumSupportedUcastAlgoPairs
Numero di algoritmi di autenticazione e crittografia supportati dalla stazione 802.11 per l'invio e la ricezione di pacchetti unicast quando configurati per l'operazione in una rete BSS (Infrastructure Basic Service Set). Il membro uInfraNumSupportedUcastAlgoPairs deve essere il numero di strutture DOT11_AUTH_CIPHER_PAIR nella matrice a cui fa riferimento il membro pInfraSupportedUcastAlgoPairs.
pInfraSupportedUcastAlgoPairs
Puntatore a una matrice di algoritmi di autenticazione e crittografia supportati dalla stazione 802.11 per l'invio e la ricezione di pacchetti unicast in una rete BSS dell'infrastruttura. Ogni voce della matrice è formattata come DOT11_AUTH_CIPHER_PAIR struttura.
uInfraNumSupportedMcastAlgoPairs
Numero di algoritmi di autenticazione e crittografia supportati dalla stazione 802.11 per l'invio e la ricezione di pacchetti multicast e broadcast quando configurati per l'operazione in una rete BSS (Infrastructure Basic Service Set). Il membro uInfraNumSupportedMcastAlgoPairs deve essere il numero di strutture DOT11_AUTH_CIPHER_PAIR nella matrice a cui fa riferimento il membro pInfraSupportedMcastAlgoPairs.
pInfraSupportedMcastAlgoPairs
Puntatore a una matrice di algoritmi di autenticazione e crittografia supportati dalla stazione 802.11 per l'invio e la ricezione di pacchetti multicast e broadcast in una rete BSS dell'infrastruttura. Ogni voce della matrice è formattata come DOT11_AUTH_CIPHER_PAIR struttura.
uAdhocNumSupportedUcastAlgoPairs
Numero di algoritmi di autenticazione e crittografia supportati dalla stazione 802.11 per l'invio e la ricezione di pacchetti unicast quando configurati per l'operazione in una rete BSS (IBSS) indipendente. Il membro uAdhocNumSupportedUcastAlgoPairs deve essere il numero di strutture DOT11_AUTH_CIPHER_PAIR nella matrice a cui fa riferimento il membro pAdhocSupportedUcastAlgoPairs.
pAdhocSupportedUcastAlgoPairs
Puntatore a una matrice di algoritmi di autenticazione e crittografia supportati dalla stazione 802.11 per l'invio e la ricezione di pacchetti unicast in una rete IBSS. Ogni voce della matrice è formattata come DOT11_AUTH_CIPHER_PAIR struttura.
uAdhocNumSupportedMcastAlgoPairs
Numero di algoritmi di autenticazione e crittografia supportati dalla stazione 802.11 per l'invio e la ricezione di pacchetti multicast e broadcast quando configurati per l'operazione in una rete IBSS. Il membro uAdhocNumSupportedMcastAlgoPairs deve essere il numero di strutture DOT11_AUTH_CIPHER_PAIR nella matrice a cui fa riferimento il membro pAdhocSupportedMcastAlgoPairs.
pAdhocSupportedMcastAlgoPairs
Puntatore a una matrice di algoritmi di autenticazione e crittografia supportati dalla stazione 802.11 per l'invio e la ricezione di pacchetti multicast e broadcast in una rete IBSS. Ogni voce della matrice è formattata come DOT11_AUTH_CIPHER_PAIR struttura.
bAutoPowerSaveMode
La funzionalità di supporto della combinazione di driver NIC/miniport per gestire in modo autonomo l'alimentazione, tra cui il rilevamento e la negoziazione del corretto Wi-Fi modalità di risparmio energia tra il dispositivo e il punto di accesso Wi-Fi. I driver NDIS 6.30 conformi Wi-Fi miniport devono impostare questo membro su TRUE.
uMaxNetworkOffloadListSize
Il numero massimo di reti che un driver miniport può eseguire l'offload, se ha la possibilità di supportare la funzionalità Di offload elenco di rete.
bMFPCapable
La funzionalità di supporto del driver NIC/miniport per supportare la protezione dei frame di gestione tra il dispositivo e il punto di accesso Wi-Fi come specificato nella specifica 802.11w-2009. Impostare su TRUE se supportato. In caso contrario, questo membro deve essere impostato su FALSE.
uInfraNumSupportedMcastMgmtAlgoPairs
Lunghezza della matrice di coppie di algoritmi di autenticazione e crittografia a cui punta pInfraSupportedMcastMgmtAlgoPairs.
pInfraSupportedMcastMgmtAlgoPairs
Puntatore a una matrice di coppie di algoritmi di autenticazione e crittografia che il dispositivo supporta per MFP in modalità Infra. La crittografia consigliata per Windows 8 è BIP con autenticazione WPA o WPA2. Ogni voce della matrice è formattata come DOT11_AUTH_CIPHER_PAIR struttura.
bNeighborReportSupported
bAPChannelReportSupported
bActionFramesSupported
bANQPQueryOffloadSupported
bHESSIDConnectionSupported
Osservazioni
Le NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES struttura contiene un membro (pExtSTAAttributes) che specifica l'indirizzo di una struttura DOT11_EXTSTA_ATTRIBUTES. Quando il driver miniport chiama NdisMSetMiniportAttributes, il driver imposta il parametro MiniportAttributes sull'indirizzo di un blocco di memoria allocato dal driver che contiene una struttura NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES insieme alla struttura DOT11_EXTSTA_ATTRIBUTES.
L'imposizione della protezione dei frame di gestione richiesta (MFPR) in Windows 8 non è supportata. Di conseguenza, i driver miniport non devono mai impostare questo bit nelle funzionalità RSN di RSN IE durante una richiesta di associazione. Per i criteri, il punto di accesso può annunciare MFPR che consentirà l'associazione di STA con supporto di MFP. I punti di accesso che non supportano la funzionalità MFP avranno esito negativo. Se MFPR è impostato da un punto di accesso e STA non è in grado di supportare MFP, Windows 8 considererà la rete come non corrispondente nella funzionalità e non invierà una richiesta di associazione al miniport.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 8 e versioni successive dei sistemi operativi Windows. |
| intestazione | windot11.h (include Ndis.h) |
Vedere anche
modalità operativa extensible station
OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST DOT11_COUNTRY_OR_REGION_STRING OID_DOT11_PRIVACY_EXEMPTION_LIST OID_DOT11_CIPHER_KEY_MAPPING_KEYPer-Station chiavi predefinite
NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES