struttura DOT11_EXTAP_ATTRIBUTES (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_EXTAP_ATTRIBUTES definisce gli attributi fisici e operativi del driver miniport e della stazione 802.11 quando opera in modalità ExtAP (Extensible Access Point).

Sintassi

typedef struct _DOT11_EXTAP_ATTRIBUTES {
  NDIS_OBJECT_HEADER              Header;
  ULONG                           uScanSSIDListSize;
  ULONG                           uDesiredSSIDListSize;
  ULONG                           uPrivacyExemptionListSize;
  ULONG                           uAssociationTableSize;
  ULONG                           uDefaultKeyTableSize;
  ULONG                           uWEPKeyValueMaxLength;
  BOOLEAN                         bStrictlyOrderedServiceClassImplemented;
  ULONG                           uNumSupportedCountryOrRegionStrings;
  PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
  ULONG                           uInfraNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedUcastAlgoPairs;
  ULONG                           uInfraNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastAlgoPairs;
} DOT11_EXTAP_ATTRIBUTES, *PDOT11_EXTAP_ATTRIBUTES;

Membri

Header

Tipo, revisione e dimensione della struttura DOT11_EXTAP_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 DOT11_EXTAP_ATTRIBUTES_REVISION_1.

Grandezza

Questo membro deve essere impostato su sizeof(DOT11_EXTAP_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.

uDesiredSSIDListSize

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.

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.

uAssociationTableSize

Numero massimo di associazioni che la stazione 802.11 può supportare contemporaneamente. La stazione 802.11 deve supportare un elenco di associazioni con almeno una voce. Una scheda di interfaccia di rete dovrebbe in genere essere in grado di supportare almeno 32 associazioni contemporaneamente.

Se la scheda di interfaccia di rete supporta gli algoritmi di autenticazione e crittografia che richiedono chiavi di mapping delle chiavi, deve supportare almeno il numero di voci nella tabella delle chiavi di mapping delle chiavi.

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(.. \wlantypes\ne-wlantypes-_dot11_cipher_algorithm.md).

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

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.

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 viene formattata come struttura DOT11_COUNTRY_OR_REGION_STRING.

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 struttura DOT11_AUTH_CIPHER_PAIR.

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 viene formattata come struttura DOT11_AUTH_CIPHER_PAIR.