OID_WDI_TASK_START_AP (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. O WDI do modelo de driver Wi-Fi anterior está no modo de manutenção e receberá apenas correções de alta prioridade.

OID_WDI_TASK_START_AP solicita que o componente IHV configure uma porta para iniciar uma Wi-Fi Proprietário do Grupo Direto na porta especificada.

Objeto	Capacidade de anulação	Prioridade padrão (política de driver de host)	Tempo de execução normal (segundos)
Porta	Sim. A anulação deve ser seguida por uma redefinição dot11.	4	1

Durante a inicialização, o driver define a funcionalidade de banda GO em 5GHz no WIFI_WIFIDIRECT_CAPABILITIES para indicar se ele pode iniciar o ponto de acesso na banda de 5 GHz.

Se o suporte à banda GO em 5 GHz estiver definido, o adaptador deverá iniciar o AP no canal Operacional Anunciado e, se isso falhar, ele deverá tentar a lista especificada no parâmetro de lista de canais de banda AP. O sistema operacional fornecerá uma dica ao driver sobre se essa AP forneceria conectividade com a Internet definindo o sinalizador DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED em WDI_TLV_P2P_GROUP_OWNER_CAPABILITY.

Se MustUseSpecifiedChannel no WDI_TLV_START_AP_PARAMETERS for especificado, a AP poderá retornar um dos seguintes erros se não for possível iniciar a AP na banda/canal(s) especificada:

• NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE: não é possível iniciar a AP nos canais especificados no momento. Tente novamente nos canais especificados mais tarde.

• NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE: não é possível iniciar a AP nas bandas especificadas no momento. Tente novamente nas bandas especificadas mais tarde.

• NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED: não é possível iniciar a AP nos canais especificados devido a motivos regulatórios.

• NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED: não é possível iniciar a AP nas bandas especificadas devido a motivos regulatórios.

Parâmetros de tarefa

TLV	Várias instâncias TLV permitidas	Opcional	Descrição
WDI_TLV_SSID			O SSID a ser usado pela AP.
WDI_TLV_START_AP_PARAMETERS			Parâmetros adicionais para essa tarefa.
WDI_TLV_AUTH_ALGO_LIST			A lista de algoritmos de autenticação que a conexão pode usar.
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST			A lista de algoritmos de criptografia multicast que a conexão pode usar.
WDI_TLV_UNICAST_CIPHER_ALGO_LIST			A lista de algoritmos de criptografia multicast que a conexão pode usar.
WDI_TLV_P2P_CHANNEL_NUMBER		X	Se especificado, isso define o canal operacional determinado na formação de grupo. Isso só pode ser especificado quando o modo de operação é Wi-Fi Direct GO.
WDI_TLV_AP_BAND_CHANNEL	X	X	Lista opcional de faixas e canais para iniciar o ponto de acesso. Se MustUseSpecifiedChannels estiver definido como 1, a AP só poderá ser iniciada nessa lista. Se não estiver definida, essa lista deverá ser uma recomendação de canais dos quais o firmware pode escolher e poderá escolher outro canal se não for possível iniciar a AP em qualquer um dos canais especificados.

Indicação de conclusão da tarefa

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 11
Servidor mínimo com suporte	Windows Server 2022
Cabeçalho	dot11wificxintf.h