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 o WiFiCx para aproveitar os recursos mais recentes. O modelo de driver Wi-Fi anterior WDI está no modo de manutenção e receberá apenas correções de alta prioridade.

OID_WDI_TASK_CONNECT solicitações para que o componente IHV se conecte a um Ponto de Acesso ou a um Wi-Fi Direct GO.

Objeto Anulação com capacidade 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 do ponto11. 4 10

Como parte da conexão, o componente IHV deve sincronizar, autenticar e associar ao BSS. O host fornece as entradas BSS às quais o componente IHV pode tentar se conectar. Depois que o componente IHV tiver se conectado com êxito a uma dessas entradas, ele deverá concluir o processo de conexão. Se não for possível se conectar a nenhuma das entradas do BSS, ele deverá concluir o processo de conexão com uma falha.

O componente IHV não precisa executar uma verificação para localizar as entradas de 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 para conexão. Se o adaptador não especificar "Conectar Substituição de Seleção do BSS", ele deverá usar apenas as entradas fornecidas pelo host para a conexão. O host pode emitir uma anulação em uma conexão pendente. Ao receber a anulação, a porta deve encerrar as tentativas de conexão e relatar uma conclusão para o host.

Se o adaptador especificar "Conectar Substituição de Seleção do BSS", ele poderá executar verificações por conta própria para encontrar entradas BSS candidatas. Ele pode se conectar a qualquer entrada BSS encontrada 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 otimizar a verificação de roaming, otimizar a seleção de AP, otimizar o processo de associação e minimizar o handshake de segurança necessário. Durante uma verificação, 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 anulada, a porta não deverá redefinir nenhuma configuração que possa ter sido configurada fora do comando connect. Ele deve dar 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 final da tentativa de associação. Isso inclui a tentativa bem-sucedida e também todas as tentativas com falha. A qualquer momento, a porta deve ser associada a no máximo um Ponto de Acesso ou Wi-Fi Direct GO.

Embora uma conexão esteja 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 pacote 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 após a conclusão da operação de associação com êxito.

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

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

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

  • A porta deve seguir as diretrizes para enviar/receber quadros de dados em operações de envio no modo FIPS e operações de recebimento no modo FIPS.
  • A porta não deve declarar suporte para nenhum 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 o TSpec e não deve executar a agregação de MSDU de transmissão.
  • A porta deve garantir que o bit compatível com SPP A-MSDU (bit 10) dos recursos de RSN que ele transmite esteja definido como zero. Somente PP A-MSDU tem suporte nesse modo.

Os parâmetros de conexão não devem ter MFPEnabled e HostFIPSModeEnabled definidos como 1. A Proteção de Quadros de Gerenciamento (802.11w) requer a porta para criptografar/descriptografar determinados quadros de gerenciamento e ação, portanto, ele não pode ser habilitado para uma conexão usando o modo FIPS do Host. Além disso, os recursos de Wake on Wireless LAN não são aplicáveis no modo Host-FIPS.

Requisitos de WiFi 7/MLO

O Windows fornece a configuração de MloConnectionSupported em WDI_TLV_CONNECTION_SETTINGS que indica se o driver pode se conectar usando MLO. Quando a conexão com 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 autenticação/criptografia não fizer parte do RSNA IE.

Para obter mais informações, consulte requisitos de recursos do 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 conectam entradas 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 rerioritizar as entradas, se necessário. Se o adaptador tiver definido o bit de Substituição de Seleção do Connect BSS, ele poderá escolher um BSS que não esteja nessa lista, desde que siga a lista Permitido/Não Permitido.

Indicação de conclusão da 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