A miniport driver makes an NDIS_STATUS_DOT11_ROAMING_START indication before the 802.11 station begins a roaming operation.
The miniport driver indicates the completion of the roaming operation through the NDIS_STATUS_DOT11_ROAMING_COMPLETION indication. Every NDIS_STATUS_DOT11_ROAMING_START indication made by the driver must have a corresponding NDIS_STATUS_DOT11_ROAMING_COMPLETION indication.
For more information about the roaming operation, see Roaming Operations.
The data type for this indication is the DOT11_ROAMING_START_PARAMETERS structure:
The miniport driver can make the NDIS_STATUS_DOT11_ROAMING_START indication only after it has completed a connection operation with a BSS network. For more information about connection operations, see Connection Operations.
Before it initiates a roaming operation, the miniport driver must allocate all of the resources that it will need to make the corresponding NDIS_STATUS_DOT11_ROAMING_COMPLETION indication.
The miniport driver calls NdisMIndicateStatusEx to make an NDIS_STATUS_DOT11_ROAMING_START indication, and must pass a pointer to an NDIS_STATUS_INDICATION structure through the StatusIndication parameter. When making this indication, the driver must set the following members of the NDIS_STATUS_INDICATION structure:
StatusCode must be set to NDIS_STATUS_DOT11_ROAMING_START.
StatusBuffer must be set to the address of a DOT11_ROAMING_START_PARAMETERS structure.
StatusBufferSize must be set to sizeof(DOT11_ROAMING_START_PARAMETERS).
|Available in Windows Vista and later versions of the Windows operating systemss.|