OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Importante

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

O OID_WDI_TASK_CONNECT solicita que o componente IHV se conecte a um Access Point (AP) ou a um Wi-Fi Direct GO.

Objeto	Compatível com interrupção	Prioridade padrão (política de driver de host)	Tempo de execução normal (segundos)
Porta	Sim. A interrupção deve ser seguida por uma redefinição dot11.	4	10

Como parte da conexão, o componente IHV deve sincronizar, autenticar e se associar ao BSS. O host fornece as entradas BSS às quais o componente IHV pode tentar se conectar. Uma vez que o componente IHV tenha se conectado a uma dessas entradas, ele deve concluir o processo de conexão. Se não conseguir se conectar a qualquer uma das entradas BSS, ele deverá concluir o processo de conexão com uma falha.

O componente IHV não precisa executar uma varredura para encontrar entradas BSS candidatas. Ele pode usar a lista fornecida pelo host para a conexão. Ele pode tentar se conectar a cada um, um após o outro. O host classifica as redes por RSSI, mas o componente IHV pode usar sua própria ordem de conexão. Se a placa não especificar "Connect BSS Selection Override", ela deverá usar apenas as entradas fornecidas pelo host para a conexão. O host pode emitir uma interrupção em uma conexão excepcional. Ao receber a interrupção a porta deve encerrar as tentativas de conexão e relatar uma conclusão ao host.

Se a placa especificar "Connect BSS Selection Override", ela poderá executar varreduras por conta própria para localizar entradas BSS candidatas. Ele pode se conectar a qualquer entrada BSS que encontrar, desde que atenda aos parâmetros configurados pelo host. Ele deve otimizar essa seleção para garantir que ela atenda a todos os requisitos de qualidade de conexão configurados. Isso pode incluir a otimização da varredura móvel, otimizar a seleção de AP, melhorar o processo de associação e minimizar o handshake de segurança necessário. Durante uma varredura, se o dispositivo precisar de parâmetros de associação adicionais para uma entrada BSS encontrada (por exemplo, PMKID para roaming), ele poderá enviar uma indicação NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST para obter os parâmetros. Quando disponível, o host configura esses parâmetros com OID_WDI_SET_ASSOCIATION_PARAMETERS.

Se a conexão falhar ou for interrompida, a porta não deverá redefinir nenhuma configuração que possa ter sido configurada fora do comando Connect. Ele deve oferecer suporte ao host que emite uma segunda chamada de conexão na mesma porta.

O status da tentativa de conexão para cada entrada BSS deve ser relatado pela porta no fim da tentativa de associação. Isso inclui tentativas que funcionam e que não funcionam. A qualquer momento, a porta deve estar associada a no máximo um Access Point ou Wi-Fi Direct GO.

Enquanto uma conexão estiver em andamento, a porta deve manter todas as conexões estabelecidas em outras portas (por exemplo, Infraestrutura ou Wi-Fi Direct). No entanto, a porta pode reduzir a quantidade de acesso médio fornecido às outras portas para concluir a conexão. Durante a conexão, o host pode enviar solicitações de envio de pacotes em outras portas.

Se o algoritmo de autenticação usado para a conexão exigir autorização de porta 802.1x para acesso à rede, o host autorizará a porta depois que a operação de associação for concluída com êxito.

A estação 802.11 usa o cache PMKID para pré-autenticação em pontos de acesso que habilitaram o algoritmo de autenticação RSNA (Robust Security Network Association). Se a estação 802.11 estiver associando ou se reassociando a um BSSID que tenha um PMKID fornecido, a estação 802.11 deverá usar os dados PMKID no elemento de informação RSN (RSN IE) de seu quadro Association ou Reassociation.

Se a porta declarar suporte para o modo Host FIPS no WIFI_STATION_CAPABILITIES, HostFIPSModeEnabled pode ser definido como 1 nos parâmetros de conexão.

Se HostFIPSModeEnabled estiver definido como 1, as seguintes regras serão aplicadas.

• A porta deve seguir as diretrizes para enviar/receber quadros de dados no modo Enviar operações no modo FIPS e Receber operações no modo FIPS.
• A porta não deve declarar suporte para qualquer protocolo QoS na solicitação de associação enviada a um ponto de acesso não-HT. O suporte a QoS é necessário para conexões HT.
• A porta não deve negociar TSpec nem executar a agregação MSDU de transmissão.
• A porta deve garantir que o bit compatível com SPP A-MSDU (bit 10) dos recursos RSN transmitidos esteja definido como zero. Somente PP A-MSDU são compatíveis neste modo.

Os parâmetros de conexão não devem ter MFPEnabled e HostFIPSModeEnabled ambos definidos como 1. A Management Frame Protection (802.11w) requer que a porta criptografe/descriptografe determinados quadros de gerenciamento e ação e, portanto, ela não pode ser habilitada para uma conexão usando o modo Host FIPS. Além disso, os recursos do Wake on Wireless LAN não são aplicáveis no modo Host FIPS.

Requisitos WiFi 7 / MLO

O Windows fornece a configuração MloConnectionSupported no WDI_TLV_CONNECTION_SETTINGS que indica se o driver pode se conectar usando MLO. Ao se conectar a uma rede segura, o driver só pode usar os pares AKM e de criptografia especificados em WDI_TLV_RSNA_AKM_CIPHER_SUITE. A única exceção é se a auth/cipher não fizer parte do RSNA IE.

Para mais informações, consulte Requisitos do recurso WiFiCx Wi-Fi 7.

Parâmetros de tarefa

TLV	Várias instâncias TLV permitidas	Opcional	Descrição
WDI_TLV_CONNECT_PARAMETERS			Os parâmetros de conexão.
WDI_TLV_CONNECT_BSS_ENTRY	X		A lista preferencial de candidatos conecta as entradas do BSS. A porta deve tentar se conectar a qualquer uma dessas entradas BSS até que a lista seja esgotada ou a conexão seja concluída com êxito. A porta pode priorizar novamente as entradas, se necessário. Se a placa tiver definido o bit Connect BSS Selection Override, ela poderá escolher um BSS que não esteja nessa lista, desde que siga a lista Allowed/Disallowed.

Indicação de conclusão de tarefa

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Indicação não solicitada

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

Requisitos

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