DOT11_EXTSTA_ATTRIBUTES struttura (windot11.h)

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_EXTSTA_ATTRIBUTES definisce gli attributi fisici e operativi del driver miniport e della stazione 802.11 quando si opera in modalità Extensible Station (ExtSTA). Per altre informazioni su questa modalità di operazione, vedere Modalità operazione estendibile stazione.

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;

Members

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 Intestazione sui valori seguenti.

Tipo

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 il driver deve essere eseguito:

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 .

Dimensione

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 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 usato 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 di indirizzi MAC escluso con almeno quattro voci.

Per altre informazioni sull'elenco di indirizzi MAC esclusi desiderati, 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 della privacy con almeno una voce.

Per altre informazioni sull'elenco di esenzione della 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 chiavi 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 la chiave predefinita e per le tabelle chiave predefinite per stazione.

Per gli algoritmi di crittografia standard 802.11, la stazione 802.11 deve supportare una dimensione di tabella di almeno quattro chiavi di crittografia. Per gli algoritmi di crittografia sviluppati dal fornitore hardware indipendente (IHV), le dimensioni della tabella possono essere quattro o successive.

uWEPKeyValueMaxLength

Lunghezza massima, in byte, di una chiave di crittografia WEP supportata dalla stazione 802.11.

Nella tabella seguente sono elencate le lunghezze minime e massime della chiave, 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 Chiavi predefinite per stazione.

bStrictlyOrderedServiceClassImplemented

Valore booleano che, se impostato su TRUE, specifica che la stazione 802.11 supporta il recapito dei pacchetti IEEE 802.11 StrictlyOrdered per il recapito dei pacchetti (MAC).

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à sicura della combinazione di driver NIC/miniport. Il sistema operativo interpreta questo membro in modo diverso a seconda del valore di Header.Revision:

Revision = 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à sicura 802.11. In caso contrario, il valore è FALSE.

Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 o superiore

Il sistema operativo interpreta il membro bSafeModeImplemented come campo bit con i valori di bit possibili impostati:

  • Se il campo bit è impostato su DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED senza altri bit impostati, il driver miniport implementa la modalità sicura 802.11.
  • Se il campo 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) Pubblicazione 140-2, Requisiti di sicurezza per i moduli crittografici.
Questo membro viene usato in combinazione con OID_DOT11_SAFE_MODE_ENABLED.

uNumSupportedCountryOrRegionStrings

Numero di stringhe di paese o area supportate dalla stazione 802.11. Se la stazione 802.11 supporta più domini normativi, come specificato dalla stazione IEEE 802.11d-2001, ogni paese o stringa di area 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 802.11 supportate dalla stazione 802.11. Ogni voce della matrice viene 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 viene 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 trasmissione 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 trasmissione in una rete BSS dell'infrastruttura. Ogni voce della matrice viene 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 viene 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 trasmissione 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 trasmissione in una rete IBSS. Ogni voce della matrice viene formattata come DOT11_AUTH_CIPHER_PAIR struttura.

bAutoPowerSaveMode

La funzionalità di supporto della combinazione di driver NIC/miniport per gestire autonomamente l'alimentazione, incluso il rilevamento e la negoziazione di Wi-Fi modalità di risparmio energia (PSM) appropriata tra il dispositivo e il punto di accesso Wi-Fi. NDIS 6.30 conforme Wi-Fi driver miniport devono impostare questo membro su TRUE.

uMaxNetworkOffloadListSize

Il numero massimo di reti che un driver miniport può scaricare, 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 in pInfraSupportedMcastMgmtAlgoPairs.

pInfraSupportedMcastMgmtAlgoPairs

Puntatore a una matrice di algoritmi di autenticazione e crittografia che supporta il dispositivo per MFP in modalità Infra. La crittografia consigliata per Windows 8 è BIP con l'autenticazione WPA o WPA2. Ogni voce della matrice viene formattata come DOT11_AUTH_CIPHER_PAIR struttura.

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

Commenti

The 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'applicazione della protezione dei frame di gestione obbligatoria (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 compatibile con 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 tratterà la rete come non corrispondente nella funzionalità e non invia una richiesta di associazione al miniport.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows 8 e versioni successive dei sistemi operativi Windows.
Intestazione windot11.h (include Ndis.h)

Vedi anche

Modalità operazione estendibile stazione

OID_DOT11_DESIRED_BSSID_LIST

OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

OID_DOT11_PMKID_LIST

OID_DOT11_DESIRED_SSID_LIST

DOT11_COUNTRY_OR_REGION_STRING

OID_DOT11_SAFE_MODE_ENABLED

OID_DOT11_PRIVACY_EXEMPTION_LIST

NDIS_OBJECT_HEADER

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_AUTH_CIPHER_PAIR

DOT11_CIPHER_ALGORITHM

Chiavi predefinite per stazione

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

OID_DOT11_SCAN_REQUEST