structure DOT11_ROAMING_START_PARAMETERS (windot11.h)

Article
02/07/2025

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_ROAMING_START_PARAMETERS spécifie la raison pour laquelle le pilote miniport Native 802.11 effectue une opération d’itinérance. Le pilote inclut une structure DOT11_ROAMING_START_PARAMETERS lorsque le pilote effectue une NDIS_STATUS_DOT11_ROAMING_START indication d’état.

Syntaxe

typedef struct DOT11_ROAMING_START_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  DOT11_MAC_ADDRESS  AdhocBSSID;
  DOT11_SSID         AdhocSSID;
  DOT11_ASSOC_STATUS uRoamingReason;
} DOT11_ROAMING_START_PARAMETERS, *PDOT11_ROAMING_START_PARAMETERS;

Membres

Header

Type, révision et taille de la structure DOT11_ROAMING_START_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_ROAMING_START_PARAMETERS_REVISION_1.

Taille

Ce membre doit être défini sur sizeof(DOT11_ROAMING_START_PARAMETERS).

Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.

AdhocBSSID

Si l’objet IEEE 802.11 dot11DesiredBSSType objet MIB est défini sur dot11_BSS_type_independent, le membre AdhocBSSID contient l’identificateur BSS (Basic Service Set) (BSSID) du réseau BSS (IBSS) indépendant vers lequel la station 802.11 tente de se déplacer.

Remarque IBSS (ad hoc) et SoftAP sont déconseillés. À compter de Windows 8.1 et Windows Server 2012 R2, utilisez Wi-Fi direct.

Si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_infrastructure, le pilote miniport doit remplir AdhocBSSID avec des zéros.

Pour plus d’informations sur le type de données de ce membre, consultez DOT11_MAC_ADDRESS.

AdhocSSID

Si l’objet dot11DesiredBSSType objet MIB est défini sur dot11_BSS_type_independent, le membre AdhocSSID contient l’identificateur de jeu de services (SSID) du réseau IBSS vers lequel la station 802.11 tente de se déplacer.

Remarque IBSS (ad hoc) et SoftAP sont déconseillés. À compter de Windows 8.1 et Windows Server 2012 R2, utilisez Wi-Fi direct.

Si l’objet dot11DesiredBSSType MIB est défini sur dot11_BSS_type_infrastructure, le pilote miniport doit remplir AdhocSSID avec des zéros.

Pour plus d’informations sur le type de données de ce membre, consultez DOT11_SSID.

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

uRoamingReason

La raison pour laquelle la station 802.11 est itinérante, qui est mise en forme comme valeur DOT11_ASSOC_STATUS.

Remarques

Pour plus d’informations sur l’opération d’itinérance, consultez opérations itinérantes.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête	windot11.h (include Ndis.h)