Compartilhar via

OID_WDI_TASK_START_AP (dot11wificxintf.h)

  • Artigo

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