estrutura DOT11_PHY_TYPE_INFO (windot11.h)

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_PHY_TYPE_INFO define parâmetros que a estação 802.11 usa para configurar um PHY ao executar uma operação de verificação explícita. A estação executa a operação de verificação explícita após uma solicitação definida de OID_DOT11_SCAN_REQUEST.

Sintaxe

typedef struct _DOT11_PHY_TYPE_INFO {
  union {
    DOT11_PHY_TYPE dot11PhyType;
    ULONG          uPhyId;
  };
  BOOLEAN             bUseParameters;
  ULONG               uProbeDelay;
  ULONG               uMinChannelTime;
  ULONG               uMaxChannelTime;
  CH_DESCRIPTION_TYPE ChDescriptionType;
  ULONG               uChannelListSize;
  UCHAR               ucChannelListBuffer[1];
} DOT11_PHY_TYPE_INFO, *PDOT11_PHY_TYPE_INFO;

Membros

dot11PhyType

O tipo de PHY que a estação 802.11 usará para a verificação. O tipo PHY é definido pela enumeração DOT11_PHY_TYPE .

Nota O driver de miniporta deve ignorar esse membro se ele estiver operando no modo ExtSTA (Estação Extensível).

bUseParameters

Se esse membro for TRUE, a estação 802.11 usará os outros membros dessa estrutura para configurar o PHY para a operação de verificação.

Se esse membro for FALSE, a estação 802.11 definirá o PHY usando suas próprias configurações para a operação de verificação.

Nota Se o driver de miniporta estiver operando no modo ExtSTA, o sistema operacional sempre definirá esse membro como FALSE.

uProbeDelay

A quantidade de tempo, em microssegundos, que a estação 802.11 deve aguardar antes de transmitir um quadro de Solicitação de Investigação 802.11 durante a verificação ativa.

uMinChannelTime

A quantidade mínima de tempo, em 802,11 unidades temporais (TU), que a estação 802,11 gasta em cada canal durante a verificação. Um TU é 1024 microssegundos.

Esse membro deve ser maior ou igual a uProbeDelay .

uMaxChannelTime

A quantidade máxima de tempo, em 802,11 unidades temporais (TU), que a estação 802.11 gasta em cada canal durante a verificação.

Esse membro deve ser maior ou igual a uProbeDelay .

ChDescriptionType

Esse membro especifica o método usado para interpretar as entradas na matriz ucChannelListBuffer . O tipo de dados desse membro é a enumeração CH_DESCRIPTION_TYPE, que declara os seguintes valores:

ch_description_type_logical

A entrada de canal é definida por um número de canal lógico para estar em conformidade com o padrão IEEE 802.11.

ch_description_type_center_frequency

A entrada de canal é definida, em unidades de megahertz (MHz), por uma frequência de central de canais.

uChannelListSize

O comprimento, em bytes, da matriz ucChannelListBuffer . Cada entrada nessa matriz é formatada como um tipo de dados ULONG.

ucChannelListBuffer[1]

Uma matriz que contém descrições de canal para o tipo PHY especificado no membro dot11PhyType .

Comentários

A estrutura DOT11_SCAN_REQUEST_V2 , que acompanha uma solicitação definida de OID_DOT11_SCAN_REQUEST, contém uma matriz de zero ou mais entradas DOT11_PHY_TYPE_INFO.

Para obter mais informações sobre as operações de verificação executadas por um driver de miniporta Nativo 802.11, consulte Operações de verificação nativas 802.11.

Para obter mais informações sobre o modo de operação ExtSTA, consulte Modo de operação de estação extensível.

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)

Confira também

DOT11_SCAN_REQUEST_V2

OID_DOT11_SCAN_REQUEST