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 une fois qu’elle reçoit une demande d’association d’une station homologue sur une infrastructure BSS.
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 l’en-tête 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 taille de(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 d’homologue qui a envoyé une demande d’association.
uStatus
État de l’association avec la station d’homologue. Si zéro, l’association réussit. Si elle n’est pas nulle, l’association échoue.
ucErrorSource
Pour les valeurs non nulles 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 d’homologue a rejeté la procédure d’association. Dans ce cas, uStatus doit être défini sur le code d’état 802.11 sous la forme du cadre d’authentification 802.11, de la trame de réponse d’association ou du cadre de réponse de nouvelle association. 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’il est modifié.
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éinscrire.
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 la trame de requête utilisée dans l’opération d’association. Le frame inclut des éléments d’information (EE), mais n’inclut pas l’en-tête MAC 802.11.
uAssocReqSize
Longueur, en octets, de la trame de requête utilisée dans l’opération d’association. Le frame inclut des éléments d’information (EE), mais n’inclut pas l’en-tête MAC 802.11.
uAssocRespOffset
Décalage du frame de réponse utilisé dans l’opération d’association. Le frame inclut des éléments d’information (EE), mais n’inclut pas l’en-tête MAC 802.11.
uAssocRespSize
Longueur du frame de réponse, en octets, utilisé dans l’opération d’association. Le frame inclut des éléments d’information (EE), mais n’inclut pas l’en-tête MAC 802.11.
AuthAlgo
Algorithme d’authentification résolu par la station 802.11 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 résolu par la station 802.11 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 multidiffusion résolu par la station 802.11 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 multidiffusion, 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.
La station extensible (ExtSTA) msDot11ActivePhyList objet MIB 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 base d’informations de gestion (MIB). 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 sur cette valeur si l’objet ExtSTA msDot11ActivePhyList MIB spécifie tous les ID PHY spécifiés par l’objet msDot11DesiredPhyList MIB. Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_ACTIVE_PHY_LIST.
Remarque Une entrée avec la valeur de DOT11_PHY_ID_ANY doit être la seule entrée dans 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, du dernier frame beacon transmis 802.11.
Le frame Beacon inclut l’en-tête de trame Beacon et tous les éléments d’information (EE), mais il n’inclut pas l’en-tête MAC 802.11. Le format de trame beacon est défini dans ISO/IEC 8802-11.
L’image Beacon doit être la dernière image utilisée par le pilote, sauf que les paramètres en temps réel ou les E/S qui varient avec le contrôle de flux de trame de données ou l’état d’association du client, comme l’horodatage, les paramètres radio, TIM, ERP et LES E/S HT, n’ont pas besoin d’être précis,
uBeaconSize
Longueur, en octets, du dernier frame beacon transmis 802.11.
Le frame Beacon inclut l’en-tête de trame Beacon et tous les éléments d’information (EE), mais il n’inclut pas l’en-tête MAC 802.11. Le format de trame beacon est défini dans ISO/IEC 8802-11.
L’image Beacon doit être la dernière image utilisée par le pilote, sauf que les paramètres en temps réel ou les E/S qui varient avec le contrôle de flux de trame de données ou l’état d’association du client, comme l’horodatage, les paramètres radio, TIM, ERP et LES E/S HT, n’ont pas besoin d’être précis,
Remarques
Le pilote miniport Native 802.11 inclut une structure de DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS lorsque le pilote effectue une NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION'indication d’état.
L’indication d’état NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION 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 initialement demandé l’association. Si l’association échoue, la carte réseau doit NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indiquer si la réponse est envoyée correctement 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 en raison d’une défaillance non liée à l’infrastructure 802.11.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures du système d’exploitation Windows. |
| d’en-tête | windot11.h (include Ndis.h) |