structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS (windot11.h)
Important
WiFiCx est le nouveau modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités. Le modèle de pilote WDI est désormais en mode maintenance et ne reçoit que des correctifs de priorité élevée.
La structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS spécifie les résultats de l’opération d’association effectuée par la station 802.11 avec un point d’accès (AP) ou une station homologue. Le pilote miniport Native 802.11 inclut une structure de DOT11_ASSOCIATION_COMPLETION_PARAMETERS lorsque le pilote miniport fait une indication d’état NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION.
Syntaxe
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;
Membres
Header
Type, révision et taille de la structure DOT11_ASSOCIATION_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_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1.
Taille
Ce membre doit être défini sur sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS).
Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.
MacAddr
Adresse MAC (Media Access Control) du point d’accès (AP) (pour les réseaux BSS d’infrastructure) ou de la station d’homologue (pour les réseaux BSS (indépendants) auxquelles la station 802.11 a tenté de se connecter.
uStatus
État d’achèvement de l’opération d’association, tel que spécifié par une valeur définie pour DOT11_ASSOC_STATUS.
bReAssocReq
Valeur booléenne qui indique si la station 802.11 a envoyé une image d’association ou de réassociation 802.11 à l’AP. Si TRUE, la station 802.11 a envoyé une trame de demande de réassociation 801.11 à l’AP. Si FAUX, la station 802.11 a envoyé une trame de demande d’association 802.11 à l’AP.
Une valeur de TRUE pour le membre bReAssocReq n’est valide que si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_infrastructure.
bReAssocResp
Valeur booléenne qui indique si la station 802.11 a reçu une trame d’association ou de réassociation 802.11 à partir de l’AP. Si TRUE, la station 802.11 a reçu une trame de réponse de réassociation 802.11 de l’AP. Si FAUX, la station 802.11 a reçu un cadre de réponse d’association 802.11 de l’AP.
Une valeur de TRUE pour le membre bReAssocResp n’est valide que si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_infrastructure.
uAssocReqOffset
Décalage de la trame de requête utilisée dans l’opération d’association. Le frame n’inclut pas l’en-tête MAC 802.11.
Ce décalage est relatif au début de la mémoire tampon qui contient la structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Le cadre de requête d’association retourné par le pilote miniport dépend du paramètre de l’ieee 802.11 dot11DesiredBSSType objet MIB :
- Si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_infrastructure, le frame est soit le cadre de demande d’association 802.11 (si bReAssocReq est FALSE) ou le cadre de requête de réassociation (si bReAssocReq est TRUE) qui a été envoyé à l’AP. Le pilote miniport doit retourner une trame de requête de sonde 802.11 envoyée par l’initiateur d’association ou créée par le pilote en fonction des informations échangées pendant l’opération d’association.
- Si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_independent, le pilote miniport doit définir le membre uAssocReqOffset sur zéro.
Le pilote miniport doit définir le uAssocReqOffset et uAssocReqSize membres sur zéro s’il n’a pas pu envoyer une trame de requête pendant l’opération d’association. Par exemple, si l’API a échoué dans la trame d’authentification 802.11 envoyée par la station 802.11, le pilote miniport doit définir uAssocReqOffset et uAssocReqSize sur zéro.
uAssocReqSize
Longueur du frame de requête utilisé dans l’opération d’association. La longueur du cadre n’inclut pas l’en-tête MAC 802.11.
Si l’objet dot11DesiredBSSType objet MIB est défini sur dot11_BSS_type_independent, le pilote miniport doit définir le uAssocReqSize membre sur zéro.
uAssocRespOffset
Décalage du frame de réponse utilisé dans l’opération d’association. Le frame n’inclut pas l’en-tête MAC 802.11.
Ce décalage est relatif au début de la mémoire tampon, qui contient la structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Le frame de réponse d’association retourné par le pilote miniport dépend du paramètre de l’ieee 802.11 dot11DesiredBSSType objet MIB :
Si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_infrastructure, le frame est soit le cadre de réponse de l’association 802.11 (si bReAssocReq est TRUE) ou réassociation Response frame (si bReAssocReq est FALSE) qui a été reçu de l’AP. Le pilote miniport doit retourner une trame de réponse de sonde 802.11 envoyée à l’initiateur d’association ou créée par le pilote en fonction des informations échangées pendant l’opération d’association.
Si l’objet dot11DesiredBSSType objet MIB est défini sur dot11_BSS_type_independent, le pilote miniport doit définir le uAssocRespOffset membre sur zéro.
Le pilote miniport doit définir le uAssocRespOffset et membres uAssocRespSize sur zéro s’il n’a pas reçu de frame de réponse pendant l’opération d’association.
uAssocRespSize
Longueur du frame de réponse utilisé dans l’opération d’association. La longueur du cadre n’inclut pas l’en-tête MAC 802.11.
Si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_independent, le pilote miniport doit définir le membre uAssocRespSize sur zéro.
uBeaconOffset
Décalage des dernières images de réponse de la sonde ou de la balise 802.11 reçues. Le pilote miniport doit exclure l’en-tête MAC 802.11 pour ces images lors de l’indication d’état NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION.
Ce décalage est relatif au début de la mémoire tampon, qui contient la structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Note
Si l’algorithme d’authentification utilisé sur l’association était Wi-Fi l’accès protégé (WPA) ou IEEE 802.11i Robust Security Network Association (RSNA), le pilote miniport doit toujours retourner le dernier cadre beacon reçu 802.11 et ne doit pas définir le uBeaconOffset et uBeaconSize membres sur zéro.
uBeaconSize
Longueur du dernier cadre beacon reçu 802.11. La longueur du cadre n’inclut pas l’en-tête MAC 802.11.
uIHVDataOffset
Décalage d’un bloc de données dans un format propriétaire défini par l’IHV. L’IHV peut utiliser ce bloc de données à des fins liées à l’indication d’état NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION.
Ce décalage est relatif au début de la mémoire tampon, qui contient la structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Si le pilote miniport ne retourne pas de données IHV dans l’indication d’état NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION, il doit définir uIHVDataOffset sur zéro.
uIHVDataSize
Longueur du bloc de données utilisé par l’IHV pour l’indication d’état NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION. Si le pilote miniport ne retourne pas de données IHV dans cette indication, il doit définir uIHVDataSize sur zéro.
AuthAlgo
Algorithme d’authentification 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 AuthAlgo, consultez DOT11_AUTH_ALGORITHM.
Le pilote miniport doit définir ce membre sur zéro si uStatus n’est pas défini sur DOT11_ASSOCIATION_STATUS_SUCCESS.
UnicastCipher
Algorithme de chiffrement unicast 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 unicastCipher, consultez DOT11_CIPHER_ALGORITHM.
Le pilote miniport doit définir ce membre sur zéro si uStatus n’est pas défini sur DOT11_ASSOCIATION_STATUS_SUCCESS.
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 MulticastCipher, consultez DOT11_CIPHER_ALGORITHM
Le pilote miniport doit définir ce membre sur zéro si uStatus n’est pas défini sur DOT11_ASSOCIATION_STATUS_SUCCESS.
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.
L’objet MIB Extensible Station (ExtSTA) msDot11ActivePhyList fait également référence à la liste PHY active.
Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_ACTIVE_PHY_LIST.
Les entrées de la liste PHY active peuvent être l’une des valeurs suivantes :
- ID PHY spécifié par l’objet ExtSTA msDot11DesiredPhyList MIB. Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_DESIRED_PHY_LIST.
- DOT11_PHY_ID_ANY. Le pilote miniport peut définir une entrée sur cette valeur si l’objet msDot11ActivePhyList MIB spécifie tous les ID PHY spécifiés par l’objet msDot11DesiredPhyList objet MIB. Une entrée avec la valeur de DOT11_PHY_ID_ANY doit être la seule entrée dans la liste PHY active.
Le décalage de la liste PHY active est relatif au début de la mémoire tampon qui contient la structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Le pilote miniport doit définir le uActivePhyListOffset et membres uActivePhyListSize sur zéro si uStatus n’est pas défini sur DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListSize
Longueur de la liste PHY active. Le membre uActivePhyListSize doit être un multiple de sizeof(ULONG).
bFourAddressSupported
Valeur booléenne qui, si elle est définie sur TRUE, spécifie que la station 802.11 a associé à une API qui prend en charge les services de système de distribution (DS) pour le pontage ISO Layer 2 sur n’importe quelle station du réseau BSS, y compris les stations mobiles et les adresses IP. La détermination de ce soutien est spécifique à l’implémentation par l’IHV.
Un pilote miniport doit définir le membre bFourAddressSupported sur FALSE si l’une des valeurs suivantes est vraie :
- L’objet IEEE 802.11 dot11DesiredBSSType MIB est défini sur dot11_BSS_type_independent.
- La station 802.11 n’a pas associé à une API qui prend en charge les services DS ou ne peut pas déterminer si l’AP prend en charge les services DS.
- Le membre uStatus n’est pas défini sur DOT11_ASSOCIATION_STATUS_SUCCESS.
bPortAuthorized
Valeur booléenne qui, si elle est définie sur TRUE, spécifie que la station 802.11 a correctement effectué l’autorisation de port pendant l’opération d’association. L’autorisation de port peut être basée sur les normes IEEE 802.1X/802.11i ou sur un algorithme propriétaire développé par l’IHV.
Le pilote miniport doit définir bPortAuthorized sur FALSE si l’une des valeurs suivantes est true :
- La station 802.11 n’effectue pas d’autorisation de port.
- Le membre uStatus n’est pas défini sur DOT11_ASSOCIATION_STATUS_SUCCESS.
Pour plus d’informations sur l’autorisation de port, consultez Port-Basedd’accès réseau.
ucActiveQoSProtocol
Indicateur qui spécifie le protocole de qualité de service (QoS) actuellement actif pour cette association. Ce membre est égal à zéro (indiquant qu’aucun protocole QoS n’est actif) ou l’un des indicateurs suivants :
DOT11_QOS_PROTOCOL_FLAG_WMM
La carte réseau utilise le protocole WMM QoS 802.11.
DOT11_QOS_PROTOCOL_FLAG_11E
La carte réseau utilise le protocole QoS 802.11e.
DSInfo
Valeur DOT11_DS_INFO qui spécifie si la station 802.11 est connectée au même DS de l’opération d’association précédente.
Le membre DSInfo est mis en forme comme énumération DOT11_DS_INFO, qui spécifie les valeurs suivantes :
DOT11_DS_CHANGED
La station 802.11 s’est connectée à une nouvelle DS après l’opération d’association.
DOT11_DS_UNCHANGED
La station 802.11 est connectée au même DS à partir de l’opération d’association.
DOT11_DS_UNKNOWN
Le pilote miniport ne peut pas déterminer si la DS a changé après l’opération d’association.
Note
Le pilote miniport doit définir DSInfo sur DOT11_DS_UNKNOWN si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_independent.
uEncapTableOffset
Décalage de la liste des encapsulations IEEE EtherType pour l’association BSS.
Ce décalage est relatif au début de la mémoire tampon, qui contient la structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS. La valeur de uEncapTableOffset doit être alignée sur une limite de 4 octets.
Le pilote miniport met en forme chaque entrée de cette liste sous la forme d’une structure DOT11_ENCAP_ENTRY.
Pour plus d’informations sur la liste des encapsulations EtherType, consultez 802.11 Encapsulation de charge utile.
uEncapTableSize
Longueur de la liste d’encapsulation EtherType.
MulticastMgmtCipher
L’algorithme de chiffrement multidiffusion choisi par la carte réseau (négocie) pour l’association pour la protection des images de gestion (MFP). Si le MFP est négocié, ce membre doit être DOT11_CIPHER_ALGO_BIP. Si la MFP n’est pas négociée, ce champ doit être DOT11_CIPHER_ALGO_NONE.
uAssocComebackTime
Lorsqu’une association (re)échoue avec le code de raison 802.11 (« Demande d’association rejetée temporairement, réessayez ultérieurement. ») ce membre indique la valeur de l’heure de retour de l’association demandée par le point d’accès (AP). Le code de raison de dissociation 802.11 est présent dans les 16 bits les plus bas de uStatus lors de la réponse à une demande d’association.
Le service de connexion automatique de Windows ajoute l’API à une liste bloquée et ne tente pas de se reconnecter pour au moins l’heure de retour indiquée. La carte réseau se comporte comme une authentification ayant échoué normalement jusqu’à ce que la séquence de connexion suivante soit commencée. Une fois que le délai d’expiration (retour) indiqué s’est écoulé et que le processus de connexion est arrêté, Windows peut trouver une meilleure connexion alternative ou revenir à cette connexion. Cette valeur définie dans ce membre doit utiliser les unités de temps définies dans la spécification 802.11. Par exemple, TU.
Remarques
Le pilote miniport doit définir le uEncapTableOffset et membres uEncapTableSize sur zéro si l’une des valeurs suivantes est vraie :
- L’association BSS ne nécessite pas de modifications apportées à la liste par défaut du système d’exploitation des encapsulations EtherType.
- Le membre uStatus n’est pas défini sur DOT11_ASSOCIATION_STATUS_SUCCESS.
- L’objet de base d’informations de gestion extensible (ExtSTA) dot11DesiredBSSType base d’informations de gestion (MIB) est défini sur dot11_BSS_type_independent.
Pour plus d’informations sur l’objet IEEE 802.11 dot11DesiredBSSType MIB, consultez OID_DOT11_DESIRED_BSS_TYPE.
Pour plus d’informations sur l’opération d’association, consultez 'opérations d’association .
Management Frame Protection est négocié lorsqu’un point d’accès (AP) et STA définissent le champ MRTC (Management Frame Protection Capable) sur 1 dans leurs E/S RSN respectives pendant la procédure d’association (re)association (c’est-à-dire. Réponse beacon ou sonde pour AP et (re)association pour STA), et les deux parties vérifient que le bit compatible Gestion Frame Protection est défini sur 1 dans l’établissement d’une liaison 4-Way (Messages M2 et M3 de la négociation 802.11i 4-way).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 8 et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | windot11.h (include Ndis.h) |