Share via

OID_WDI_TASK_CONNECT

  • Artigo

Importante

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

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

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 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 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 BSS", ele poderá executar verificações por conta própria para localizar entradas de 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 aos 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 não deve ser associada a mais de um Ponto de Acesso ou Wi-Fi Direct GO.

Enquanto uma conexão está 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 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 Association ou Reassociation.

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

Se HostFIPSModeEnabled for definido como 1, as regras a seguir se aplicarão.

  • 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 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 têm suporte nesse modo.

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

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 rerioritizar as entradas, se necessário. Se o adaptador tiver definido o bit Conectar Substituição de Seleção 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 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

Cliente mínimo com suporte

Windows 10

Servidor mínimo com suporte

Windows Server 2016

Cabeçalho

 Dot11wdi.h