estrutura DOT11_ROAMING_START_PARAMETERS (windot11.h)

Artigo
03/01/2024

Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte Modelo de driver universal do Windows da WLAN.

A estrutura DOT11_ROAMING_START_PARAMETERS especifica o motivo pelo qual o driver de miniporto Native 802.11 está executando uma operação de roaming. O driver inclui uma estrutura DOT11_ROAMING_START_PARAMETERS quando o driver faz um NDIS_STATUS_DOT11_ROAMING_START indicação status.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura DOT11_ROAMING_START_PARAMETERS. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O driver de miniporta deve definir os membros de Header para os seguintes valores:

Tipo

Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.

Revisão

Esse membro deve ser definido como DOT11_ROAMING_START_PARAMETERS_REVISION_1.

Tamanho

Esse membro deve ser definido como sizeof(DOT11_ROAMING_START_PARAMETERS).

Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.

AdhocBSSID

Se o objeto IEEE 802.11 dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_independent, o membro AdhocBSSID conterá o BSSID (identificador BSS) da rede independente BSS (IBSS) para a qual a estação 802.11 está tentando fazer roaming.

Nota O IBSS (Ad hoc) e o SoftAP foram preteridos. Começando com Windows 8.1 e Windows Server 2012 R2, use Wi-Fi Direct.

Se o objeto MIB dot11DesiredBSSType estiver definido como dot11_BSS_type_infrastructure, o driver de miniporto deverá preencher AdhocBSSID com zeros.

Para obter mais informações sobre o tipo de dados desse membro, consulte DOT11_MAC_ADDRESS.

AdhocSSID

Se o objeto MIB dot11DesiredBSSType estiver definido como dot11_BSS_type_independent, o membro AdhocSSID conterá o identificador do conjunto de serviços (SSID) da rede IBSS para a qual a estação 802.11 está tentando fazer roaming.

Nota O IBSS (Ad hoc) e o SoftAP foram preteridos. Começando com Windows 8.1 e Windows Server 2012 R2, use Wi-Fi Direct.

Se o objeto MIB dot11DesiredBSSType estiver definido como dot11_BSS_type_infrastructure, o driver de miniporto deverá preencher AdhocSSID com zeros.

Para obter mais informações sobre o tipo de dados desse membro, consulte DOT11_SSID.

Para obter mais informações sobre o objeto MIB IEEE 802.11 dot11DesiredBSSType , consulte OID_DOT11_DESIRED_BSS_TYPE.

uRoamingReason

O motivo pelo qual a estação 802.11 está em roaming, que é formatada como um valor DOT11_ASSOC_STATUS .

Comentários

Para obter mais informações sobre a operação de roaming, consulte Operações de roaming.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	windot11.h (inclua Ndis.h)