DOT11_ROAMING_START_PARAMETERS structure (windot11.h)

Article
09/14/2024

Important

WiFiCx is the new Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features. The WDI driver model is now in maintenance mode and will only receive high priority fixes.

The DOT11_ROAMING_START_PARAMETERS structure specifies the reason why the Native 802.11 miniport driver is performing a roaming operation. The driver includes a DOT11_ROAMING_START_PARAMETERS structure when the driver makes an NDIS_STATUS_DOT11_ROAMING_START status indication.

Syntax

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;

Members

Header

The type, revision, and size of the DOT11_ROAMING_START_PARAMETERS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type

This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision

This member must be set to DOT11_ROAMING_START_PARAMETERS_REVISION_1.

Size

This member must be set to sizeof(DOT11_ROAMING_START_PARAMETERS).

For more information about these members, see NDIS_OBJECT_HEADER.

AdhocBSSID

If the IEEE 802.11 dot11DesiredBSSType MIB object is set to dot11_BSS_type_independent, the AdhocBSSID member contains the basic service set (BSS) identifier (BSSID) of the independent BSS (IBSS) network that the 802.11 station is attempting to roam to.

Note IBSS (Ad hoc) and SoftAP are deprecated. Starting with Windows 8.1 and Windows Server 2012 R2, use Wi-Fi Direct.

If the dot11DesiredBSSType MIB object is set to dot11_BSS_type_infrastructure, the miniport driver must fill AdhocBSSID with zeros.

For more information about the data type for this member, see DOT11_MAC_ADDRESS.

AdhocSSID

If the dot11DesiredBSSType MIB object is set to dot11_BSS_type_independent, the AdhocSSID member contains the service set identifier (SSID) of the IBSS network that the 802.11 station is attempting to roam to.

Note IBSS (Ad hoc) and SoftAP are deprecated. Starting with Windows 8.1 and Windows Server 2012 R2, use Wi-Fi Direct.

If the dot11DesiredBSSType MIB object is set to dot11_BSS_type_infrastructure, the miniport driver must fill AdhocSSID with zeros.

For more information about the data type for this member, see DOT11_SSID.

For more information about the IEEE 802.11 dot11DesiredBSSType MIB object, see OID_DOT11_DESIRED_BSS_TYPE.

uRoamingReason

The reason that the 802.11 station is roaming, which is formatted as a DOT11_ASSOC_STATUS value.

Remarks

For more information about the roaming operation, see Roaming Operations.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Header	windot11.h (include Ndis.h)

Share via