estrutura DOT11_WFD_DISCOVER_REQUEST (windot11.h)
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 OID_DOT11_WFD_DISCOVER_REQUEST são os dados de entrada de uma solicitação 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 miniporto deve definir os membros do 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_WFD_DISCOVER_REQUEST_REVISION_1.
Tamanho
Esse membro deve ser definido como tamanhos de(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 do dispositivo.
uDeviceFilterListOffset
O deslocamento para a lista de filtros de dispositivo P2P, que especifica os dispositivos P2P e proprietários de grupos 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 do InformationBuffer do NDIS_OID_REQUEST em que começa uma lista de identificadores de dispositivo P2P. 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 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 VERDADEIRO, 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.
Observações
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 no 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.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Versions:_Supported no Windows 8 |
| cabeçalho | windot11.h (inclua Windot11.h) |