структура DOT11_ROAMING_START_PARAMETERS (windot11.h)

Статья
02/07/2025

Важный

WiFiCx — это новая модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций. Модель драйвера WDI теперь находится в режиме обслуживания и получит только исправления с высоким приоритетом.

Структура DOT11_ROAMING_START_PARAMETERS указывает причину, по которой драйвер минипорта Native 802.11 выполняет перемещение. Драйвер включает структуру DOT11_ROAMING_START_PARAMETERS при создании драйвера NDIS_STATUS_DOT11_ROAMING_START указание состояния.

Синтаксис

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;

Члены

Header

Тип, редакция и размер структуры DOT11_ROAMING_START_PARAMETERS. Этот элемент отформатирован как структура NDIS_OBJECT_HEADER.

Минипорт-драйвер должен задать члены заголовка следующими значениями:

Тип

Этот элемент должен иметь значение NDIS_OBJECT_TYPE_DEFAULT.

Пересмотр

Этот элемент должен иметь значение DOT11_ROAMING_START_PARAMETERS_REVISION_1.

Размер

Этот элемент должен иметь значение sizeof(DOT11_ROAMING_START_PARAMETERS).

Дополнительные сведения об этих членах см. в NDIS_OBJECT_HEADER.

AdhocBSSID

Если для объекта IEEE 802.11 dot11DesiredBSSType MIB установлено значение dot11_BSS_type_independent, элемент AdhocBSSID содержит базовый идентификатор службы (BSSID) независимой сети BSS (IBSS), в которую пытается перемещаться станция 802.11.

примечание IBSS (ad hoc) и SoftAP устарели. Начиная с Windows 8.1 и Windows Server 2012 R2, используйте Wi-Fi Direct.

Если для объекта dot11DesiredBSSType MIB установлено значение dot11_BSS_type_infrastructure, драйвер минипорта должен заполнить AdhocBSSID нулями.

Дополнительные сведения о типе данных для этого элемента см. в DOT11_MAC_ADDRESS.

AdhocSSID

Если для объекта dot11DesiredBSSType MIB задано значение dot11_BSS_type_independent, элемент AdhocSSID содержит идентификатор набора служб (SSID) сети IBSS, на которую пытается перемещаться станция 802.11.

примечание IBSS (ad hoc) и SoftAP устарели. Начиная с Windows 8.1 и Windows Server 2012 R2, используйте Wi-Fi Direct.

Если для объекта dot11DesiredBSSType MIB установлено значение dot11_BSS_type_infrastructure, драйвер минипорта должен заполнить adhocSSID нулями.

Дополнительные сведения о типе данных для этого элемента см. в DOT11_SSID.

Дополнительные сведения о объекте IEEE 802.11 dot11DesiredBSSType MIB см. в разделе OID_DOT11_DESIRED_BSS_TYPE.

uRoamingReason

Причина перемещения станции 802.11, которая форматируется как значение DOT11_ASSOC_STATUS.

Замечания

Дополнительные сведения об операции перемещения см. в перемещаемых операций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
заголовка	windot11.h (include Ndis.h)