estrutura DOT11_WFD_DEVICE_ENTRY (windot11.h)

Artigo
02/07/2025

Importante

WiFiCx é o novo modelo de driver Wi-Fi lançado no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes. O modelo de driver WDI agora está no modo de manutenção e receberá apenas correções de alta prioridade.

A estrutura DOT11_WFD_DEVICE_ENTRY contém informações sobre um dispositivo Wi-Fi Direct (WFD) descoberto, um GO (Proprietário do Grupo WFD) descoberto ou um ponto de acesso de infraestrutura descoberto. Essa estrutura é retornada de um OID_DOT11_WFD_ENUM_DEVICE_LIST e de uma notificação NDIS_STATUS_DOT11_WFD_DISCOVER_COMPLETE.

Sintaxe

typedef struct _DOT11_WFD_DEVICE_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  DOT11_MAC_ADDRESS                 TransmitterAddress;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullBeaconHostTimestamp;
  ULONGLONG                         ullProbeResponseHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBeaconIEsOffset;
  ULONG                             uBeaconIEsLength;
  ULONG                             uProbeResponseIEsOffset;
  ULONG                             uProbeResponseIEsLength;
}  DOT11_WFD_DEVICE_ENTRY, *PDOT11_WFD_DEVICE_ENTRY;

Membros

uPhyId

O identificador do PHY que o miniporto usou para detectar o dispositivo. Esse identificador está no intervalo de índice da lista de PHYs com suporte retornados de uma solicitação de consulta OID_DOT11_SUPPORTED_PHY_TYPES. Esse identificador não pode ser DOT_PHY_ID_ANY.

PhySpecificInfo

Os atributos do PHY identificados por uPhyId.

dot11BSSID

O endereço MAC do dispositivo que enviou o pacote de resposta de sinalizador ou investigação durante uma descoberta.

dot11BSSType

O tipo de rede BSS. Esse membro está definido como dot11_BSS_type_infrastructure para todos os dispositivos WFD descobertos e GOs WFD.

TransmitterAddress

O endereço MAC do transmissor do dispositivo que enviou o pacote de resposta de sinalizador ou investigação durante uma descoberta.

lRSSI

O valor do indicador de força de sinal recebido do dispositivo descoberto. As unidades para esse valor estão em decibéis referenciados a 1 miliwatt (dBm).

uLinkQuality

Valor de qualidade do link variando de 0 a 100. Um valor de 100 indica a mais alta qualidade do link.

usBeaconPeriod

O valor recebido do campo de intervalo de sinalizador do pacote de resposta de baliza ou investigação mais recente.

ullTimestamp

O valor recebido do campo de carimbo de data/hora do pacote de resposta de sinalizador ou investigação mais recente.

ullBeaconHostTimestamp

O carimbo de data/hora, determinado por um valor retornado de NdisGetCurrentSystemTime, registrando a hora em que o pacote de sinalizador foi recebido.

ullProbeResponseHostTimestamp

O carimbo de data/hora, determinado por um valor retornado de NdisGetCurrentSystemTime, registrando a hora em que o pacote de resposta de investigação foi recebido.

usCapabilityInformation

O valor recebido do campo de funcionalidade do pacote de resposta de baliza ou investigação mais recente.

uBeaconIEsOffset

O deslocamento, em bytes, desde o início dessa estrutura da lista de elementos de informação (IEs) do último pacote de sinalizador recebido desse dispositivo. Se nenhum pacote de sinalizador foi recebido, esse valor deve ser 0.

uBeaconIEsLength

O comprimento, em bytes, dos IEs em uBeaconIEsOffset. Esse é um valor de comprimento exato e não contém nenhum preenchimento para alinhamento. Se nenhum pacote de sinalizador foi recebido, esse valor deve ser 0.

uProbeResponseIEsOffset

O deslocamento, em bytes, desde o início dessa estrutura da lista de IEs (elementos de informação) do último pacote de resposta de investigação recebido desse dispositivo. Se nenhum pacote de sinalizador foi recebido, esse valor deve ser 0.

uProbeResponseIEsLength

O comprimento, em bytes, dos IEs em uProbeResponseIEsOffset. Esse é um valor de comprimento exato e não contém nenhum preenchimento para alinhamento. Se nenhum pacote de resposta de investigação tiver sido recebido, esse valor deverá ser 0.