estrutura WLAN_PHY_RADIO_STATE (wlanapi.h)

Artigo
03/13/2024

A estrutura WLAN_PHY_RADIO_STATE especifica o estado de rádio em um tipo PHY (camada física) específico.

Sintaxe

typedef struct _WLAN_PHY_RADIO_STATE {
  DWORD             dwPhyIndex;
  DOT11_RADIO_STATE dot11SoftwareRadioState;
  DOT11_RADIO_STATE dot11HardwareRadioState;
} WLAN_PHY_RADIO_STATE, *PWLAN_PHY_RADIO_STATE;

Membros

dwPhyIndex

O índice do tipo PHY no qual o estado de rádio está sendo definido ou consultado. A função WlanGetInterfaceCapability retorna uma lista de tipos PHY válidos.

dot11SoftwareRadioState

Um valor DOT11_RADIO_STATE que indica o estado de rádio do software.

dot11HardwareRadioState

Um valor DOT11_RADIO_STATE que indica o estado de rádio de hardware.

Comentários

A estrutura WLAN_PHY_RADIO_STATE é usada com a função WlanSetInterface quando o parâmetro OpCode é definido como wlan_intf_opcode_radio_state.

A estrutura WLAN_PHY_RADIO_STATE também é usada para notificação pelo MSM (módulo específico de mídia) quando o estado de rádio é alterado. Um aplicativo se registra para receber notificações MSM chamando a função WlanRegisterNotification com o parâmetro dwNotifSource definido como um valor que inclui WLAN_NOTIFICATION_SOURCE_MSM. Para obter mais informações sobre essas notificações, consulte a estrutura de WLAN_NOTIFICATION_DATA e a referência de enumeração WLAN_NOTIFICATION_MSM .

O estado de rádio de um PHY estará desativado se dot11SoftwareRadioState ou dot11HardwareRadioState membro da estrutura WLAN_PHY_RADIO_STATE for dot11_radio_state_off.

O estado de rádio de hardware não pode ser alterado chamando a função WlanSetInterface . O membro dot11HardwareRadioState da estrutura WLAN_PHY_RADIO_STATE é ignorado quando a função WlanSetInterface é chamada com o parâmetro OpCode definido como wlan_intf_opcode_radio_state e o parâmetro pData aponta para uma estrutura WLAN_PHY_RADIO_STATE .

O estado de rádio de software pode ser alterado chamando a função WlanSetInterface .

Alterar o estado de rádio de software de um adaptador de rede física pode causar alterações relacionadas no estado dos estados de rádio rede hospedada sem fio ou adaptador sem fio virtual. Os PHYs de cada adaptador sem fio virtual estão vinculados. Para obter mais informações, consulte Sobre a rede hospedada sem fio.

O estado de rádio de um PHY estará desativado se o estado de rádio de software (membro dot11SoftwareRadioState ) ou o estado de rádio de hardware (membro dot11HardwareRadioState ) estiver desativado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	wlanapi.h