estrutura DOT11_WFD_DISCOVER_REQUEST (windot11.h)

Artigo
08/08/2023

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

A estrutura OID_DOT11_WFD_DISCOVER_REQUEST são os dados de entrada de uma solicitação de OID_DOT11_WFD_DISCOVER_REQUEST . A estrutura contém os parâmetros para uma descoberta de dispositivo Wi-Fi Direct.

Sintaxe

typedef struct _DOT11_WFD_DISCOVER_REQUEST {
  NDIS_OBJECT_HEADER      Header;
  DOT11_WFD_DISCOVER_TYPE DiscoverType;
  DOT11_WFD_SCAN_TYPE     ScanType;
  ULONG                   uDiscoverTimeout;
  ULONG                   uDeviceFilterListOffset;
  ULONG                   uNumDeviceFilters;
  ULONG                   uIEsOffset;
  ULONG                   uIEsLength;
  BOOLEAN                 bForceScanLegacyNetworks;
} DOT11_WFD_DISCOVER_REQUEST, *PDOT11_WFD_DISCOVER_REQUEST;

Membros

Header

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

O driver de miniporte deve definir os membros de Cabeçalho para os seguintes valores:

Tipo

Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.

Revisão

Esse membro deve ser definido como DOT11_WFD_DISCOVER_REQUEST_REVISION_1.

Tamanho

Esse membro deve ser definido como sizeof(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1).

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

DiscoverType

O modo de descoberta de dispositivo a ser usado.

ScanType

Tipo de verificação usado durante a fase de verificação da descoberta do dispositivo.

uDiscoverTimeout

Tempo máximo, em milissegundos, para concluir a operação de descoberta. Um miniporto pode concluir uma descoberta em menos tempo, no entanto, ele não deve usar mais tempo do que o especificado por esse valor. Esse é o tempo total permitido para a conclusão de todas as fases da descoberta de dispositivos.

uDeviceFilterListOffset

O deslocamento para a lista de filtros de dispositivo P2P, que especifica os dispositivos P2P e proprietários de grupo a serem pesquisados durante Wi-Fi descoberta direta de dispositivos. Esse deslocamento é especificado em bytes e é relativo ao início do buffer que contém a estrutura DOT11_WFD_DISCOVER_REQUEST. Cada entrada na lista é formatada como um DOT11_WFD_DISCOVER_DEVICE_FILTER.

Quando uma entrada de lista especifica um endereço MAC não difundido como a ID do Dispositivo, o driver deve usar esse endereço MAC no atributo ID do dispositivo dos IEs P2P que ele inclui nas solicitações de investigação.

O deslocamento no InformationBuffer do NDIS_OID_REQUEST em que uma lista de identificadores de dispositivo P2P começa. Esses são os identificadores para durante a descoberta do dispositivo.

uNumDeviceFilters

O número de filtros de dispositivo P2P a serem usados durante a descoberta do dispositivo WFD. O valor padrão para esse campo é 0.

uIEsOffset

O deslocamento no InformationBuffer da estrutura NDIS_OID_REQUEST em que os elementos informativos adicionais (IEs) começam.

uIEsLength

O comprimento, em bytes, dos IEs adicionais que a porta do dispositivo Wi-Fi Direct deve adicionar ao pacote de solicitação de investigação. Se esse valor for 0, o sistema não forneceu nenhum IEs e o miniporto deverá inserir os IEs padrão no pacote de solicitação de investigação. Os IEs padrão estão em DefaultRequestIEs recebidos anteriormente com uma solicitação de OID_DOT11_WFD_ADDITIONAL_IE .

bForceScanLegacyNetworks

Quando TRUE, o dispositivo Wi-Fi Direct também deve tentar descobrir redes herdadas. Caso contrário, a verificação de redes herdadas não é necessária.

Comentários

Cada entrada na lista de identificadores de dispositivo em uDeviceFilterListOffset é formatada como uma estrutura DOT11_MAC_ADDRESS . Quando um endereço MAC não difundido é especificado nesta lista, o driver deve usar esse endereço no atributo ID do dispositivo das solicitações de investigação de IEs P2P que ele transmite

Os IEs presentes em uIEsOffset, durante a descoberta do dispositivo, substituirão temporariamente os IEs encontrados em DefaultRequestIEs na estrutura de entrada da solicitação de OID_DOT11_WFD_ADDITIONAL_IE .