struttura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS (windot11.h)
La struttura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS specifica i risultati dell'operazione di associazione eseguita dalla stazione 802.11 dopo che riceve una richiesta di associazione da una stazione peer su un BSS dell'infrastruttura.
Sintassi
typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS PeerMacAddr;
ULONG uStatus;
UCHAR ucErrorSource;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;
Members
Header
Tipo, revisione e dimensioni della struttura DOT11_INCOMING_ASSOC_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_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1.
Dimensione
Questo membro deve essere impostato su sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS).
Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.
PeerMacAddr
Indirizzo MAC (Media Access Control) della stazione peer che ha inviato una richiesta di associazione.
uStatus
Stato dell'associazione con la stazione peer. Se zero, l'associazione ha esito positivo. Se diverso da zero, l'associazione ha esito negativo.
ucErrorSource
Per i valori diversi da zero di uStatus, questo membro indica l'origine dell'errore che impedisce l'associazione. La scheda di interfaccia di rete deve impostare ucErrorSource su uno dei valori seguenti:
DOT11_ASSOC_ERROR_SOURCE_OS
Il driver miniport ha rifiutato la procedura di associazione a causa di errori di sistema, ad esempio errori di memoria insufficiente. In questo caso , uStatus deve essere impostato sul NDIS_STATUS_XXX o NTSTATUS_XXX codice restituito dal sistema operativo.
DOT11_ASSOC_ERROR_SOURCE_REMOTE
L'AP o la peer station ha rifiutato la procedura di associazione. In questo caso , uStatus deve essere impostato sul formato del codice di stato 802.11 nel frame di autenticazione 802.11, nel frame di risposta di associazione o nel frame di risposta di riesezione dell'associazione. La tabella 19 nella specifica IEEE 802.11-2003 contiene tutti i valori possibili. Il driver miniport può anche restituire nuovi valori in questa specifica IEEE quando viene modificato.
DOT11_ASSOC_ERROR_SOURCE_OTHER
L'associazione non è riuscita per un motivo specifico di IHV. In questo caso , uStatus contiene un valore diverso da zero specificato dall'IHV.
bReAssocReq
Valore booleano che indica se la richiesta dalla peer station è una richiesta di ri-associazione.
bReAssocResp
Valore booleano che indica se la risposta dalla scheda di interfaccia di rete è una richiesta di riesecuzione dell'associazione.
uAssocReqOffset
Offset del frame di richiesta utilizzato nell'operazione di associazione. Il frame include elementi informativi (IEs), ma non include l'intestazione MAC 802.11.
uAssocReqSize
Lunghezza, in byte, del frame di richiesta utilizzato nell'operazione di associazione. Il frame include elementi informativi (IEs), ma non include l'intestazione MAC 802.11.
uAssocRespOffset
Offset del frame di risposta utilizzato nell'operazione di associazione. Il frame include elementi informativi (IEs), ma non include l'intestazione MAC 802.11.
uAssocRespSize
Lunghezza del frame di risposta, in byte, utilizzata nell'operazione di associazione. Il frame include elementi informativi (IEs), ma non include l'intestazione MAC 802.11.
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.
UnicastCipher
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 UnicastCipher , vedere DOT11_CIPHER_ALGORITHM.
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.
uActivePhyListOffset
Offset dell'elenco di identificatori PHY (ID) utilizzati dalla stazione 802.11 per inviare o ricevere pacchetti sulla connessione di rete BSS. Ogni voce è un valore ULONG.
La stazione Estendibile (ExtSTA) msDot11ActivePhyList MIB objec fa riferimento anche all'elenco PHY attivo.
Le voci nell'elenco PHY attivo possono essere uno dei valori seguenti:
- ID PHY specificato dall'oggetto Extensible Station (ExtSTA) msDot11DesiredPhyList management information base (MIB). Per altre informazioni su questo oggetto MIB, vedere OID_DOT11_DESIRED_PHY_LIST.
-
ID PHY di DOT11_PHY_ID_ANY. Il driver miniport può impostare una voce su questo valore se l'oggetto MIB ExtSTA msDot11ActivePhyList specifica tutti gli ID PHY specificati dall'oggetto MIB msDot11DesiredPhyList . Per altre informazioni su questo oggetto MIB, vedere OID_DOT11_ACTIVE_PHY_LIST.
Nota Una voce con il valore di DOT11_PHY_ID_ANY deve essere l'unica voce nell'elenco PHY attivo.
uActivePhyListSize
Lunghezza, in byte, dell'elenco PHY attivo. Il membro uActivePhyListSize deve essere un multiplo di sizeof(ULONG).
uBeaconOffset
Offset, in byte, dell'ultimo frame beacon trasmesso 802.11.
Il frame Beacon include l'intestazione del frame Beacon e tutti gli elementi informativi (IEs), ma non include l'intestazione MAC 802.11. Il formato frame Beacon è definito in ISO/IEC 8802-11.
Il frame Beacon deve essere il fotogramma più recente usato dal driver, ad eccezione del fatto che i parametri o gli IE in tempo reale che variano con il controllo del flusso dei frame di dati o lo stato dell'associazione client, ad esempio timestamp, parametri di opzione, TIM, ERP e HT IEs, non devono essere accurati,
uBeaconSize
Lunghezza, in byte, dell'ultimo frame beacon trasmesso 802.11.
Il frame Beacon include l'intestazione del frame Beacon e tutti gli elementi informativi (IEs), ma non include l'intestazione MAC 802.11. Il formato frame Beacon è definito in ISO/IEC 8802-11.
Il frame Beacon deve essere il fotogramma più recente usato dal driver, ad eccezione del fatto che i parametri o gli IE in tempo reale che variano con il controllo del flusso dei frame di dati o lo stato dell'associazione client, ad esempio timestamp, parametri di opzione, TIM, ERP e HT IEs, non devono essere accurati,
Commenti
Il driver miniport Nativo 802.11 include una struttura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS quando il driver crea un NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indicazione dello stato.
L'indicazione dello stato NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION contrassegna la fine di un blocco di indicazione di associazione. Se l'associazione ha esito positivo, la scheda di interfaccia di rete deve fare l'indicazione NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION dopo che ha inviato correttamente il frame di risposta di associazione corrispondente alla stazione che ha originariamente richiesto l'associazione. Se l'associazione non riesce, la scheda di interfaccia di rete deve indicare NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION se la risposta viene inviata correttamente o meno. L'errore può essere dovuto al fatto che la scheda di interfaccia di rete o il sistema operativo rifiutano la richiesta di associazione o a causa di un errore non correlato al framework 802.11.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive del sistema operativo Windows. |
| Intestazione | windot11.h (include Ndis.h) |