struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS (windot11.h)
Importante
L'interfaccia LAN wireless Native 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_ASSOCIATION_COMPLETION_PARAMETERS specifica i risultati dell'operazione di associazione eseguita dalla stazione 802.11 con un punto di accesso (AP) o una stazione peer. Il driver miniport Nativo 802.11 include una struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS quando il driver miniport crea un'indicazione di stato NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION .
Sintassi
typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS MacAddr;
DOT11_ASSOC_STATUS uStatus;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
ULONG uIHVDataOffset;
ULONG uIHVDataSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
BOOLEAN bFourAddressSupported;
BOOLEAN bPortAuthorized;
UCHAR ucActiveQoSProtocol;
DOT11_DS_INFO DSInfo;
ULONG uEncapTableOffset;
ULONG uEncapTableSize;
DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
ULONG uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;
Members
Header
Tipo, revisione e dimensioni della struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .
Il driver miniport deve impostare i membri di Header sui valori seguenti:
Tipo
Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.
Revisione
Questo membro deve essere impostato su DOT11_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1.
Dimensione
Questo membro deve essere impostato su sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS).
Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.
MacAddr
Indirizzo MAC (Media Access Control) del punto di accesso (AP) (per le reti BSS dell'infrastruttura) o della stazione peer (per reti BSS (IBSS) indipendenti) a cui la stazione 802.11 ha tentato di connettersi.
uStatus
Stato di completamento dell'operazione di associazione, come specificato da un valore definito per DOT11_ASSOC_STATUS.
bReAssocReq
Valore booleano che indica se la stazione 802.11 ha inviato un frame 802.11 Association o Reassociation all'AP. Se TRUE, la stazione 802.11 ha inviato un frame di richiesta di associazione 801.11 all'AP. Se FALSE, la stazione 802.11 ha inviato un frame di richiesta di associazione 802.11 all'AP.
Il valore TRUE per il membro bReAssocReq è valido solo se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_infrastructure.
bReAssocResp
Valore booleano che indica se la stazione 802.11 ha ricevuto un frame 802.11 Association o Reassociation dall'AP. Se TRUE, la stazione 802.11 ha ricevuto un frame di risposta 802.11 dall'AP. Se FALSE, la stazione 802.11 ha ricevuto un frame di risposta di associazione 802.11 dall'AP.
Il valore TRUE per il membro bReAssocResp è valido solo se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_infrastructure.
uAssocReqOffset
Offset del frame di richiesta utilizzato nell'operazione di associazione. Il frame non include l'intestazione MAC 802.11.
Questo offset è relativo all'inizio del buffer che contiene la struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Il frame Association Request restituito dal driver miniport dipende dall'impostazione dell'oggetto MIB IEEE 802.11 dot11DesiredBSSType :
- Se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_infrastructure, il frame è il frame 802.11 Association Request frame (se bReAssocReq è FALSE) o Reassociation Request frame (se bReAssocReq è TRUE) inviato all'API. Il driver miniport deve restituire un frame di richiesta probe 802.11 inviato dall'iniziatore di associazione o creato dal driver in base alle informazioni scambiate durante l'operazione di associazione.
- Se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_independent, il driver miniport deve impostare il membro uAssocReqOffset su zero.
Il driver miniport deve impostare i membri uAssocReqOffset e uAssocReqSize su zero se non è stato possibile inviare un frame di richiesta durante l'operazione di associazione. Ad esempio, se l'API non è riuscita nel frame di autenticazione 802.11 inviato dalla stazione 802.11, il driver miniport deve impostare uAssocReqOffset e uAssocReqSize su zero.
uAssocReqSize
Lunghezza del frame di richiesta utilizzato nell'operazione di associazione. La lunghezza del frame non include l'intestazione MAC 802.11.
Se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_independent, il driver miniport deve impostare il membro uAssocReqSize su zero.
uAssocRespOffset
Offset del frame di risposta utilizzato nell'operazione di associazione. Il frame non include l'intestazione MAC 802.11.
Questo offset è relativo all'inizio del buffer, che contiene la struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Il frame di risposta di associazione restituito dal driver miniport dipende dall'impostazione dell'oggetto MIB IEEE 802.11 dot11DesiredBSSType :
Se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_infrastructure, il frame è il frame 802.11 Association Response frame (se bReAssocReq è TRUE) o Reassociation Response frame (se bReAssocReq è FALSE) ricevuto dall'AP. Il driver miniport deve restituire un frame di risposta probe 802.11 inviato all'iniziatore di associazione o creato dal driver in base alle informazioni scambiate durante l'operazione di associazione.
Se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_independent, il driver miniport deve impostare il membro uAssocRespOffset su zero.
Il driver miniport deve impostare i membri uAssocRespOffset e uAssocRespSize su zero se non ha ricevuto un frame di risposta durante l'operazione di associazione.
uAssocRespSize
Lunghezza del frame di risposta utilizzato nell'operazione di associazione. La lunghezza del frame non include l'intestazione MAC 802.11.
Se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_independent, il driver miniport deve impostare il membro uAssocRespSize su zero.
uBeaconOffset
Offset dell'ultimo fotogramma 802.11 Beacon o Probe Response frame. Il driver miniport deve escludere l'intestazione MAC 802.11 per questi fotogrammi quando si effettua l'indicazione dello stato NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION.
Questo offset è relativo all'inizio del buffer, che contiene la struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Nota
Se l'algoritmo di autenticazione utilizzato per l'associazione è stato Wi-Fi Protected Access (WPA) o IEEE 802.11i Robust Security Network Association (RSNA), il driver miniport deve sempre restituire l'ultimo frame beacon ricevuto 802.11 e non deve impostare i membri uBeaconOffset e uBeaconSize su zero.
uBeaconSize
La lunghezza dell'ultimo fotogramma 802.11 Beacon. La lunghezza del frame non include l'intestazione MAC 802.11.
uIHVDataOffset
Offset di un blocco di dati in un formato proprietario definito dall'IHV. L'IHV può usare questo blocco di dati per qualsiasi scopo correlato all'indicazione dello stato di NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION .
Questo offset è relativo all'inizio del buffer, che contiene la struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Se il driver miniport non restituisce dati IHV nell'indicazione di stato NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION , deve impostare uIHVDataOffset su zero.
uIHVDataSize
Lunghezza del blocco di dati utilizzato dall'IHV per l'indicazione dello stato NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION . Se il driver miniport non restituisce dati IHV in questa indicazione, deve impostare uIHVDataSize su zero.
AuthAlgo
Algoritmo di autenticazione 802.11 risolto con la stazione AP o peer durante l'operazione di associazione. Per altre informazioni sul tipo di dati per il membro AuthAlgo , vedere DOT11_AUTH_ALGORITHM.
Il driver miniport deve impostare questo membro su zero se uStatus non è impostato su DOT11_ASSOCIATION_STATUS_SUCCESS.
UnicastCipher
Algoritmo di crittografia unicast risolto dalla stazione 802.11 con la stazione AP o peer durante l'operazione di associazione. Per altre informazioni sul tipo di dati per il membro UnicastCipher , vedere DOT11_CIPHER_ALGORITHM.
Il driver miniport deve impostare questo membro su zero se uStatus non è impostato su DOT11_ASSOCIATION_STATUS_SUCCESS.
MulticastCipher
Algoritmo di crittografia multicast risolto dalla stazione 802.11 con la stazione AP o peer durante l'operazione di associazione. Per altre informazioni sul tipo di dati per il membro MulticastCipher , vedere DOT11_CIPHER_ALGORITHM
Il driver miniport deve impostare questo membro su zero se uStatus non è impostato su DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListOffset
Offset dell'elenco di identificatori PHY (ID) utilizzati dalla stazione 802.11 per inviare o ricevere pacchetti sulla connessione di rete BSS.
L'oggetto MIB Extensible Station (ExtSTA) msDot11ActivePhyList fa riferimento anche all'elenco PHY attivo.
Per altre informazioni su questo oggetto MIB, vedere OID_DOT11_ACTIVE_PHY_LIST.
Le voci nell'elenco PHY attivo possono essere uno dei valori seguenti:
- ID PHY specificato dall'oggetto EXTSTA msDot11DesiredPhyList MIB. Per altre informazioni su questo oggetto MIB, vedere OID_DOT11_DESIRED_PHY_LIST.
- DOT11_PHY_ID_ANY. Il driver miniport può impostare una voce su questo valore se l'oggetto MIB msDot11ActivePhyList specifica tutti gli ID PHY specificati dall'oggetto MIB msDot11DesiredPhyList . Una voce con il valore di DOT11_PHY_ID_ANY deve essere l'unica voce nell'elenco PHY attivo.
L'offset dell'elenco PHY attivo è relativo all'inizio del buffer che contiene la struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Il driver miniport deve impostare i membri uActivePhyListOffset e uActivePhyListSize su zero se uStatus non è impostato su DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListSize
Lunghezza dell'elenco PHY attivo. Il membro uActivePhyListSize deve essere un multiplo di sizeof(ULONG).
bFourAddressSupported
Valore booleano che, se impostato su TRUE, specifica che la stazione 802.11 è associata a un'API che supporta i servizi DS (Distribution System) per il bridging ISO Layer 2 in qualsiasi stazione della rete BSS, incluse le stazioni mobili e i punti di accesso. La determinazione di questo supporto è specifica per l'implementazione da parte dell'IHV.
Un driver miniport deve impostare il membro bFourAddressSupported su FALSE se una delle condizioni seguenti è true:
- L'oggetto MIB IEEE 802.11 dot11DesiredBSSType è impostato su dot11_BSS_type_independent.
- La stazione 802.11 non è stata associata a un'API che supporta i servizi DS o non è in grado di determinare se l'AP supporta i servizi DS.
- Il membro uStatus non è impostato su DOT11_ASSOCIATION_STATUS_SUCCESS.
bPortAuthorized
Valore booleano che, se impostato su TRUE, specifica che la stazione 802.11 ha eseguito correttamente l'autorizzazione della porta durante l'operazione di associazione. L'autorizzazione delle porte può essere basata sugli standard IEEE 802.1X/802.11i o su un algoritmo proprietario sviluppato dall'IHV.
Il driver miniport deve impostare bPortAuthorized su FALSE se si verifica una delle condizioni seguenti:
- La stazione 802.11 non esegue l'autorizzazione delle porte.
- Il membro uStatus non è impostato su DOT11_ASSOCIATION_STATUS_SUCCESS.
Per altre informazioni sull'autorizzazione della porta, vedere Accesso alla rete basata sulla porta.
ucActiveQoSProtocol
Flag che specifica il protocollo QoS (Quality of Service) attualmente attivo per questa associazione. Questo membro è zero (che indica che non è attivo alcun protocollo QoS) o uno dei flag seguenti:
DOT11_QOS_PROTOCOL_FLAG_WMM
La scheda di interfaccia di rete usa il protocollo QoS 802.11 WMM.
DOT11_QOS_PROTOCOL_FLAG_11E
La scheda di interfaccia di rete usa il protocollo QoS 802.11e.
DSInfo
Valore DOT11_DS_INFO che specifica se la stazione 802.11 è connessa allo stesso DS dall'operazione di associazione precedente.
Il membro DSInfo viene formattato come enumerazione DOT11_DS_INFO, che specifica i valori seguenti:
DOT11_DS_CHANGED
La stazione 802.11 è connessa a una nuova DS dopo l'operazione di associazione.
DOT11_DS_UNCHANGED
La stazione 802.11 è connessa alla stessa DS dall'operazione di associazione.
DOT11_DS_UNKNOWN
Il driver miniport non può determinare se il DS è cambiato dopo l'operazione di associazione.
Nota
Il driver miniport deve impostare DSInfo su DOT11_DS_UNKNOWN se l'oggetto MIB dot11DesiredBSSType è impostato su dot11_BSS_type_independent.
uEncapTableOffset
Offset dell'elenco di incapsulazioni IEEE EtherType per l'associazione BSS.
Questo offset è relativo all'inizio del buffer, che contiene la struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS. Il valore di uEncapTableOffset deve essere allineato a un limite a 4 byte.
Il driver miniport formatta ogni voce in questo elenco come struttura DOT11_ENCAP_ENTRY .
Per altre informazioni sull'elenco di incapsulamento EtherType, vedere 802.11 Payload Encapsulation.
uEncapTableSize
Lunghezza dell'elenco di incapsulamento EtherType.
MulticastMgmtCipher
L'algoritmo di crittografia multicast scelto dalla scheda di interfaccia di rete (negozia) per l'associazione per la protezione dei frame di gestione (MFP). Se MFP viene negoziato, questo membro deve essere DOT11_CIPHER_ALGO_BIP. Se MFP non viene negoziato, questo campo deve essere DOT11_CIPHER_ALGO_NONE.
uAssocComebackTime
Quando un'associazione (re)non riesce con il codice 30 motivo 802.11 ("Richiesta di associazione rifiutata temporaneamente, riprovare più tardi.") questo membro indica il valore dell'ora di ritorno dell'associazione richiesta dal punto di accesso (AP). Il codice motivo di associazione 802.11 è presente nel codice 16 bit più basso di uStatus quando risponde a una richiesta di associazione.
Il servizio di connessione automatica di Windows aggiungerà l'API a un elenco bloccato e non tenterà di riconnettersi per almeno il tempo di ritorno indicato. La scheda di interfaccia di rete si comporta come un'autenticazione regolare non riuscita fino all'avvio della sequenza di connessione successiva. Dopo aver trascorso il timeout(comeback) indicato e il processo di connessione viene arrestato Windows potrebbe trovare una connessione alternativa migliore o tornare a questa connessione. Questo valore impostato in questo membro deve usare le unità temporali definite nella specifica 802.11. Ad esempio, TU.
Commenti
Il driver miniport deve impostare i membri uEncapTableOffset e uEncapTableSize su zero se uno dei seguenti è true:
- L'associazione BSS non richiede modifiche all'elenco predefinito del sistema operativo di incapsulamento EtherType.
- Il membro uStatus non è impostato su DOT11_ASSOCIATION_STATUS_SUCCESS.
- L'oggetto Extensible Station (ExtSTA) dot11DesiredBSSType (MIB) è impostato su dot11_BSS_type_independent.
Per altre informazioni sull'oggetto MIB IEEE 802.11 Dot11DesiredBSSType , vedere OID_DOT11_DESIRED_BSS_TYPE.
Per altre informazioni sull'operazione di associazione, vedere Operazioni di associazione.
La protezione frame di gestione viene negoziata quando un punto di accesso (AP) e STA imposta il campo Management Frame Protection Capable (MFPC) su 1 nei rispettivi IES RSN durante la procedura di associazione (re)association (ad esempio. Beacon o Probe Response for AP e (re)association request for STA) e entrambe le parti confermano che il bit Management Frame Protection Capable è impostato su 1 nella handshake a 4 Way (Messaggi M2 e M3 della handshake 802.11i a 4 vie).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 8 e versioni successive dei sistemi operativi Windows. |
| Intestazione | windot11.h (include Ndis.h) |