structure DOT11_ROAMING_START_PARAMETERS (windot11.h)

Article
02/27/2024

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_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 status indication.

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 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_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 MIB IEEE 802.11 Dot11DesiredBSSType 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.

Note IBSS (ad hoc) et SoftAP sont déconseillés. En commençant par Windows 8.1 et Windows Server 2012 R2, utilisez Wi-Fi Direct.

Si l’objet MIB dot11DesiredBSSType 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 MIB dot11DesiredBSSType a la valeur 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.

Note IBSS (ad hoc) et SoftAP sont déconseillés. En commençant par Windows 8.1 et Windows Server 2012 R2, utilisez Wi-Fi Direct.

Si l’objet MIB dot11DesiredBSSType a la valeur 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 MIB IEEE 802.11 dot11DesiredBSSType , consultez OID_DOT11_DESIRED_BSS_TYPE.

uRoamingReason

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 d’itinérance.

Configuration requise

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