OID_WDI_TASK_P2P_DISCOVER (dot11wificxintf.h)

Importante

Este tópico faz parte do modelo de driver WiFiCx. WiFiCx é o modelo de driver Wi-Fi lançado em Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes. A WDI do modelo de driver de Wi-Fi anterior está no modo de manutenção e receberá apenas correções de alta prioridade.

OID_WDI_TASK_P2P_DISCOVER é emitido para o dispositivo para executar Wi-Fi descoberta direta.

Objeto	Capacidade de anulação	Prioridade padrão (política de driver de host)	Tempo de execução normal (segundos)
Porta	Sim. A porta deve estar em um estado limpo após a anulação.	6	15

O comando contém propriedades que definem um conjunto específico de Wi-Fi Dispositivos diretos a serem pesquisados ou descoberta curinga.

Wi-Fi descoberta direta é mutuamente exclusiva da verificação de Wi-Fi padrão. Enquanto essa tarefa estiver em execução, as solicitações de investigação de difusão não deverão ser enviadas sem um SSID "DIRECT-" ou um SSID GO específico. Essas solicitações de investigação também devem incluir todos os IEs diretos Wi-Fi necessários.

O host pode ter critérios de pesquisa que não são fornecidos como parte dos parâmetros de tarefa até o dispositivo. O host poderá usar o mecanismo de anulação de tarefa se tiver correspondido aos critérios necessários, portanto, é importante que o dispositivo possa anular Wi-Fi tarefas de Descoberta Direta rapidamente para não prejudicar o desempenho do cenário.

Quando a tarefa tiver sido concluída (normalmente ou devido a uma anulação), a porta deverá estar em um bom estado, de modo que outra solicitação de descoberta possa ser emitida nessa porta.

Parâmetros de tarefa

TLV	Várias instâncias TLV permitidas	Opcional	Descrição
WDI_TLV_P2P_DISCOVER_MODE			Informações do modo de descoberta, como tipo de verificação, contagem e tempo entre verificações.
WDI_TLV_SCAN_DWELL_TIME			Verificando as configurações de tempo de espera.
WDI_TLV_P2P_DISCOVERY _CHANNEL_SETTINGS	X	X	Duração da verificação e lista de canais a serem digitalizados. Quando especificadas, as configurações de escuta substituem as especificadas em WDI_TLV_SCAN_DWELL_TIME. Se essa lista estiver vazia, a porta deverá verificar em todos os canais com suporte e usar as configurações de escuta do WDI_TLV_SCAN_DWELL_TIME.
WDI_TLV_SSID	X	X	Uma lista de SSIDs que a porta deve verificar. Pode haver vários SSIDs nessa lista e um deles pode ser um curinga. Ao fazer uma verificação ativa em um canal, a porta deve enviar uma solicitação de investigação para cada SSID na lista. Se essa lista estiver vazia, a porta deverá verificar todos os SSIDs.
WDI_TLV_P2P_SERVICE_NAME_HASH	X	X	Uma lista de nomes de Hash de Serviço a serem consultados. Obrigatório se WDI_P2P_SERVICE_DISCOVERY_TYPE_SERVICE_NAME_ONLY ou WDI_P2P_SERVICE_DISCOVERY_TYPE_ASP2_SERVICE_NAME_ONLY for especificado.
WDI_TLV_VENDOR_SPECIFIC_IE	X		Um ou mais IEs que devem ser incluídos nas solicitações de investigação enviadas pela porta. Esses IEs não são usados para verificação passiva.
WDI_TLV_P2P_SERVICE_INFORMATION_DISCOVERY_ENTRY	X	X	Uma lista opcional de Entradas de Descoberta de Informações de Serviço a serem consultadas. Isso será necessário se WDI_P2P_SERVICE_DISCOVERY_TYPE_SERVICE_INFORMATION for especificado. Espera-se que o driver execute uma descoberta de serviço P2P por solicitação/resposta de investigação usando o hash do nome do serviço. Para cada entrada de serviço que contém informações de serviço, espera-se que o driver execute uma solicitação/resposta de consulta ANQP para consultar as informações do serviço.
WDI_TLV_P2P_ASP2_SERVICE_INFORMATION_DISCOVERY_ENTRY	X	X	Uma lista opcional de Entradas de Descoberta de Informações do Serviço ASP2 a serem consultadas. Isso será necessário se WDI_P2P_SERVICE_DISCOVERY_TYPE_ASP2_SERVICE_INFORMATION for especificado. Espera-se que o driver execute uma descoberta de serviço P2P por solicitação/resposta de investigação usando o hash do nome do serviço. Para cada entrada de serviço que contém informações de serviço, espera-se que o driver execute uma solicitação/resposta de consulta ANQP para consultar as informações do serviço.
WDI_TLV_P2P_INCLUDE_LISTEN_CHANNEL		X	Especifica se a solicitação de investigação deve incluir o atributo Listen Channel durante a descoberta.

Indicação de conclusão de tarefa

NDIS_STATUS_WDI_INDICATION_P2P_DISCOVERY_COMPLETE

Indicação não solicitada

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 11
Servidor mínimo com suporte	Windows Server 2022
parâmetro	dot11wificxintf.h