structure DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS (windot11.h)
La structure DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS spécifie les résultats de l’opération d’association effectuée par la station 802.11 après avoir reçu une demande d’association d’une station homologue sur une BSS d’infrastructure.
Syntaxe
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;
Membres
Header
Type, révision et taille de la structure DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS. Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .
Le pilote miniport doit définir les membres de Header sur les valeurs suivantes :
Type
Ce membre doit être défini sur NDIS_OBJECT_TYPE_DEFAULT.
Révision
Ce membre doit être défini sur DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1.
Taille
Ce membre doit être défini sur sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS).
Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.
PeerMacAddr
Adresse MAC (Media Access Control) de la station homologue qui a envoyé une demande d’association.
uStatus
Status de l’association avec la station d’homologue. Si zéro, l’association réussit. Si la valeur n’est pas nulle, l’association échoue.
ucErrorSource
Pour les valeurs différentes de zéro de uStatus, ce membre indique la source de l’erreur qui empêche l’association. La carte réseau doit définir ucErrorSource sur l’une des valeurs suivantes :
DOT11_ASSOC_ERROR_SOURCE_OS
Le pilote miniport a rejeté la procédure d’association en raison d’erreurs système, telles que des erreurs de mémoire insuffisante. Dans ce cas, uStatus doit être défini sur le code NDIS_STATUS_XXX ou NTSTATUS_XXX retourné par le système d’exploitation.
DOT11_ASSOC_ERROR_SOURCE_REMOTE
L’AP ou la station homologue a rejeté la procédure d’association. Dans ce cas, uStatus doit être défini sur le code 802.11 status du cadre d’authentification 802.11, du cadre de réponse d’association ou du cadre de réponse de réassodation. Le tableau 19 de la spécification IEEE 802.11-2003 contient toutes les valeurs possibles. Le pilote miniport peut également retourner de nouvelles valeurs dans cette spécification IEEE lorsqu’elle est modifiée.
DOT11_ASSOC_ERROR_SOURCE_OTHER
L’association a échoué pour une raison spécifique à IHV. Dans ce cas, uStatus contient une valeur différente de zéro spécifiée par l’IHV.
bReAssocReq
Valeur booléenne qui indique si la requête de la station homologue est une demande de réassoration.
bReAssocResp
Valeur booléenne qui indique si la réponse de la carte réseau est une demande de re-association.
uAssocReqOffset
Décalage de l’image de requête utilisée dans l’opération d’association. Le cadre inclut des éléments d’information (EE), mais n’inclut pas l’en-tête MAC 802.11.
uAssocReqSize
Longueur, en octets, de l’image de requête utilisée dans l’opération d’association. Le cadre inclut des éléments d’information (EE), mais n’inclut pas l’en-tête MAC 802.11.
uAssocRespOffset
Décalage du cadre de réponse utilisé dans l’opération d’association. Le cadre inclut des éléments d’information (EE), mais n’inclut pas l’en-tête MAC 802.11.
uAssocRespSize
Longueur du cadre de réponse, en octets, utilisé dans l’opération d’association. Le cadre inclut des éléments d’information (EE), mais n’inclut pas l’en-tête MAC 802.11.
AuthAlgo
Algorithme d’authentification que la station 802.11 a résolu avec la station homologue pendant l’opération d’association. Pour plus d’informations sur le type de données du membre AuthAlgo , consultez DOT11_AUTH_ALGORITHM.
UnicastCipher
Algorithme de chiffrement unicast que la station 802.11 a résolu avec la station homologue pendant l’opération d’association. Pour plus d’informations sur le type de données du membre UnicastCipher , consultez DOT11_CIPHER_ALGORITHM.
MulticastCipher
Algorithme de chiffrement de multidiffusion que la station 802.11 a résolu avec l’AP ou la station homologue pendant l’opération d’association. Pour plus d’informations sur le type de données du membre MulticastCipher , consultez DOT11_CIPHER_ALGORITHM.
uActivePhyListOffset
Décalage de la liste des identificateurs PHY (ID) que la station 802.11 utilise pour envoyer ou recevoir des paquets sur la connexion réseau BSS. Chaque entrée est une valeur ULONG.
L’objec MIB MIB Extensible Station (ExtSTA) msDot11ActivePhyList fait également référence à la liste PHY active.
Les entrées de la liste PHY active peuvent être l’une des valeurs suivantes :
- ID PHY spécifié par l’objet MIB (Extensible Station) msDot11DesiredPhyList . Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_DESIRED_PHY_LIST.
-
ID PHY de DOT11_PHY_ID_ANY. Le pilote miniport peut définir une entrée à cette valeur si l’objet MIB ExtSTA msDot11ActivePhyList spécifie tous les ID PHY spécifiés par l’objet MIB msDot11DesiredPhyList . Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_ACTIVE_PHY_LIST.
Note Une entrée avec la valeur DOT11_PHY_ID_ANY doit être la seule entrée de la liste PHY active.
uActivePhyListSize
Longueur, en octets, de la liste PHY active. Le membre uActivePhyListSize doit être un multiple de sizeof(ULONG).
uBeaconOffset
Décalage, en octets, de la dernière image de balise 802.11 transmise.
L’image Beacon inclut l’en-tête du cadre Beacon et tous les éléments d’information (EE), mais elle n’inclut pas l’en-tête MAC 802.11. Le format de trame Beacon est défini dans ISO/IEC 8802-11.
La trame Beacon doit être la dernière image utilisée par le pilote, sauf que les paramètres en temps réel ou les EI en temps réel qui varient avec le contrôle de flux de trame de données, ou l’association du client status tels que l’horodatage, les paramètres radio, TIM, ERP et HT IE, n’ont pas besoin d’être précis,
uBeaconSize
Longueur, en octets, de la dernière image de balise 802.11 transmise.
L’image Beacon inclut l’en-tête du cadre Beacon et tous les éléments d’information (EE), mais elle n’inclut pas l’en-tête MAC 802.11. Le format de trame Beacon est défini dans ISO/IEC 8802-11.
La trame Beacon doit être la dernière image utilisée par le pilote, sauf que les paramètres en temps réel ou les EI en temps réel qui varient avec le contrôle de flux de trame de données, ou l’association du client status tels que l’horodatage, les paramètres radio, TIM, ERP et HT IE, n’ont pas besoin d’être précis,
Remarques
Le pilote miniport Native 802.11 comprend une structure DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS lorsque le pilote effectue un NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION status indication.
L’indication NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION status marque la fin d’un bloc d’indication d’association. Si l’association réussit, la carte réseau doit indiquer la NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION une fois qu’elle a correctement envoyé le cadre de réponse d’association correspondant à la station qui a demandé l’association à l’origine. Si l’association échoue, la carte réseau doit indiquer NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indique si la réponse a été envoyée avec succès ou non. L’échec peut être dû au fait que la carte réseau ou le système d’exploitation rejettent la demande d’association ou à cause d’une défaillance non liée à l’infrastructure 802.11.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 7 et versions ultérieures du système d’exploitation Windows. |
| En-tête | windot11.h (inclure Ndis.h) |