structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS (windot11.h)

Article
08/08/2023

Important

L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

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 DOT11_ASSOCIATION_COMPLETION_PARAMETERS lorsque le pilote miniport effectue une indication status 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 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_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 de contrôle d’accès multimédia (MAC) du point d’accès (AP) (pour les réseaux BSS d’infrastructure) ou de la station homologue (pour les réseaux BSS indépendants (IBSS) auquel la station 802.11 a tenté de se connecter.

uStatus

L’achèvement status de l’opération d’association, comme 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 la valeur est TRUE, la station 802.11 a envoyé une trame de demande de réassociation 801.11 au point d’accès. Si la valeur est FALSE, la station 802.11 a envoyé une trame de demande d’association 802.11 au point d’accès.

La valeur TRUE pour le membre bReAssocReq est valide uniquement si l’objet MIB dot11DesiredBSSType est défini sur dot11_BSS_type_infrastructure.

bReAssocResp

Valeur booléenne qui indique si la station 802.11 a reçu une image d’association ou de réassociation 802.11 de l’AP. Si la valeur EST TRUE, la station 802.11 a reçu une trame de réponse de réassociation 802.11 de l’AP. Si la valeur est FALSE, la station 802.11 a reçu une trame de réponse d’association 802.11 de l’AP.

La valeur TRUE pour le membre bReAssocResp est valide uniquement si l’objet MIB dot11DesiredBSSType est défini sur dot11_BSS_type_infrastructure.

uAssocReqOffset

Décalage de l’image de requête utilisée dans l’opération d’association. Le cadre 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 demande d’association retourné par le pilote miniport dépend du paramètre de l’objet MIB IEEE 802.11 dot11DesiredBSSType :

Si l’objet MIB dot11DesiredBSSType a la valeur dot11_BSS_type_infrastructure, le frame est soit le frame 802.11 Association Request (si bReAssocReq a la valeur FALSE) soit le cadre de demande d’association (si bReAssocReq a la valeur TRUE) qui a été envoyé à l’AP. Le pilote miniport doit retourner une trame de demande de sonde 802.11 envoyée par l’initiateur de l’association ou créée par le pilote en fonction des informations échangées pendant l’opération d’association.
Si l’objet MIB dot11DesiredBSSType 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 les membres uAssocReqOffset et uAssocReqSize sur zéro s’il n’a pas pu envoyer une trame de requête pendant l’opération d’association. Par exemple, si le point d’accès a échoué le cadre d’authentification 802.11 envoyé par la station 802.11, le pilote miniport doit définir uAssocReqOffset et uAssocReqSize sur zéro.

uAssocReqSize

Longueur de l’image de requête utilisée dans l’opération d’association. La longueur du cadre n’inclut pas l’en-tête MAC 802.11.

Si l’objet MIB dot11DesiredBSSType est défini sur dot11_BSS_type_independent, le pilote miniport doit définir le membre uAssocReqSize sur zéro.

uAssocRespOffset

Décalage du cadre de réponse utilisé dans l’opération d’association. Le cadre 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 réponse d’association retourné par le pilote miniport dépend du paramètre de l’objet MIB IEEE 802.11 dot11DesiredBSSType :

Si l’objet MIB dot11DesiredBSSType a la valeur dot11_BSS_type_infrastructure, le frame est soit le cadre de réponse d’association 802.11 (si bReAssocReq a la valeur TRUE) soit le cadre de réponse de réassociation (si bReAssocReq a la valeur 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 de l’association ou créée par le pilote en fonction des informations échangées pendant l’opération d’association.
Si l’objet MIB dot11DesiredBSSType est défini sur dot11_BSS_type_independent, le pilote miniport doit définir le membre uAssocRespOffset sur zéro.
Le pilote miniport doit définir les membres uAssocRespOffset et uAssocRespSize sur zéro s’il n’a pas reçu de cadre de réponse pendant l’opération d’association.

uAssocRespSize

Longueur du cadre 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 MIB dot11DesiredBSSType a la valeur 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 balise ou de sonde 802.11 reçues. Le pilote miniport doit exclure l’en-tête MAC 802.11 pour ces images lors de l’NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION status indication.

Ce décalage est relatif au début de la mémoire tampon, qui contient la structure DOT11_ASSOCIATION_COMPLETION_PARAMETERS.

Notes

Si l’algorithme d’authentification utilisé sur l’association était Wi-Fi WPA (Accès protégé) ou IEEE 802.11i Robust Security Network Association (RSNA), le pilote miniport doit toujours retourner la dernière image beacon 802.11 reçue et ne doit pas définir les membres uBeaconOffset et uBeaconSize 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 status 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 status 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 status 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 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 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 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 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 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

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 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 MIB ExtSTA msDot11DesiredPhyList . 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 à cette valeur si l’objet MIB msDot11ActivePhyList spécifie tous les ID PHY spécifiés par l’objet MIB msDot11DesiredPhyList . Une entrée avec la valeur DOT11_PHY_ID_ANY doit être la seule entrée de 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 les membres uActivePhyListOffset et 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 été associée à un POINT d’accès qui prend en charge les services de système de distribution (DS) pour le pontage iso-couche 2 sur n’importe quelle station du réseau BSS, y compris les stations mobiles et les points d’accès. La détermination de cette prise en charge est spécifique à l’implémentation par l’IHV.

Un pilote miniport doit définir le membre bFourAddressSupported sur FALSE si l’un des éléments suivants est true :

L’objet MIB IEEE 802.11 dot11DesiredBSSType est défini sur dot11_BSS_type_independent.
La station 802.11 ne s’est pas associée à un point d’accès 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 conditions suivantes est vraie :

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 Accès réseau basé sur les ports.

ucActiveQoSProtocol

Indicateur qui spécifie le protocole de qualité de service (QoS) actuellement actif pour cette association. Ce membre est égal à zéro (ce qui indique 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 à partir de l’opération d’association précédente.

Le membre DSInfo est mis en forme en tant qu’é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 à la même DS à partir de l’opération d’association.

DOT11_DS_UNKNOWN

Le pilote miniport ne peut pas déterminer si le DS a changé après l’opération d’association.

Notes

Le pilote miniport doit définir DSInfo sur DOT11_DS_UNKNOWN si l’objet MIB dot11DesiredBSSType a la valeur 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 en tant que structure DOT11_ENCAP_ENTRY .

Pour plus d’informations sur la liste d’encapsulations EtherType, consultez 802.11 Payload Encapsulation.

uEncapTableSize

Longueur de la liste d’encapsulation EtherType.

MulticastMgmtCipher

Algorithme de chiffrement de multidiffusion que la carte réseau choisit (négocie) pour l’association pour la protection des cadres de gestion (MFP). Si la MFP est négociée, 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 (re)association échoue avec le code de raison 802.11 30 (« Demande d’association rejetée temporairement, réessayez plus tard. ») ce membre indique la valeur de l’heure de retour d’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 d’uStatus lors de la réponse à une demande d’association.

Le service de connexion automatique de Windows ajoute l’AP à une liste bloquée et ne tente pas de se reconnecter pendant au moins l’heure de retour indiquée. La carte réseau se comporte comme une authentification ayant échoué jusqu’à ce que la séquence de connexion suivante soit démarrée. Une fois le délai d’expiration (retour) indiqué écoulé et le processus de connexion 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 les membres uEncapTableOffset et uEncapTableSize sur zéro si l’une des conditions suivantes est vraie :

L’association BSS ne nécessite pas de modification de la liste par défaut des encapsulations EtherType du système d’exploitation.
Le membre uStatus n’est pas défini sur DOT11_ASSOCIATION_STATUS_SUCCESS.
L’objet MIB (Extensible Station) dot11DesiredBSSType management information base (MIB) est défini sur dot11_BSS_type_independent.

Pour plus d’informations sur l’objet MIB IEEE 802.11 dot11DesiredBSSType , consultez OID_DOT11_DESIRED_BSS_TYPE.

Pour plus d’informations sur l’opération d’association, consultez Opérations d’association.

La protection des cadres de gestion est négociée lorsqu’un point d’accès (AP) et sta définissent le champ MFPC (Management Frame Protection) sur 1 dans leurs E/S RSN respectifs pendant la procédure (re)association (c’est-à-dire. Réponse de balise ou de sonde pour AP et (re)association request for STA), et les deux parties confirment le bit Management Frame Protection défini sur 1 dans la négociation 4-Way (messages M2 et M3 de la négociation 802.11i 4-way).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 8 et versions ultérieures des systèmes d’exploitation Windows.
En-tête	windot11.h (inclure Ndis.h)