title

ms.topic

description

ms.date

keywords

OID_WDI_TASK_ROAM (dot11wificxintf.h)

reference

The OID_WDI_TASK_ROAM command requests that the adapter tries to roam from the currently connected AP to a new one.

07/31/2021

OID_WDI_TASK_ROAM Network Drivers Starting with Windows Vista

OID_WDI_TASK_ROAM (dot11wificxintf.h)

[!INCLUDE WiFiCx topic note]

OID_WDI_TASK_ROAM requests that the adapter tries to roam from the currently connected AP to a new one.

Object	Abort capable	Default priority (host driver policy)	Normal execution time (seconds)
Port	Yes. If aborted after disassociation, it must be followed by a dot11 reset.	4	10

The Microsoft component provides the list of preferred BSS entries that the adapter should consider for roaming.

When this command issued, if its currently associated, the adapter would need to disassociate from the currently connected AP and then roam to the new AP. In this case it would first indicate disassociation for the old AP, then indicate association result for the new AP and then complete the task.

It can also determine not to perform the roam and stay connected to the current AP. In this case it would only complete the task without any association or disassociation indications.

The scan and AP selection requirements for this task are same as for OID_WDI_TASK_CONNECT.

Task parameters

TLV	Multiple TLV instances allowed	Optional	Description
WDI_TLV_CONNECT_PARAMETERS			Connection parameters.
WDI_TLV_CONNECT_BSS_ENTRY	X		The preferred list of candidate connect BSS entries. The port should attempt to connect to these BSS entries until the list is exhausted, or the connection completed successfully. The port can reprioritize the entries if needed. If the adapter has set the Connect BSS Selection Override bit, then it can pick a BSS that is not in this list as long as it follows the Allowed/Disallowed list requirements.