Compartir a través de

OID_WDI_TASK_CONNECT

  • Artículo

Importante

Este tema forma parte del modelo de controlador WDI publicado en Windows 10. El modelo de controlador WDI está en modo de mantenimiento y solo recibirá correcciones de prioridad alta. WiFiCx es el modelo de controlador Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes.

OID_WDI_TASK_CONNECT solicita que el componente IHV se conecte a un punto de acceso o a un Wi-Fi Direct GO.

Object Anular compatible Prioridad predeterminada (directiva de controlador de host) Tiempo de ejecución normal (segundos)
Port Sí. La anulación debe ser seguida de un restablecimiento dot11. 4 10

Como parte de la conexión, el componente IHV debe sincronizarse, autenticarse y asociarse al BSS. El host proporciona las entradas de BSS a las que el componente IHV puede intentar conectarse. Una vez que el componente IHV se haya conectado correctamente a una de esas entradas, debe completar el proceso de conexión. Si no se puede conectar a cualquiera de las entradas de BSS, debe completar el proceso de conexión con un error.

El componente IHV no necesita realizar un examen para buscar entradas de BSS candidatas. Puede usar la lista proporcionada por el host para la conexión. Puede intentar conectarse a cada uno, uno después de otro. El host ordena las redes por RSSI, pero el componente IHV puede usar su propio orden de conexión. Si el adaptador no especifica "Connect BSS Selection Override", solo debe usar las entradas proporcionadas por el host para la conexión. El host puede emitir una anulación en una conexión pendiente. Al recibir la anulación, el puerto debe finalizar los intentos de conexión e informar de una finalización al host.

Si el adaptador especifica "Connect BSS Selection Override", puede realizar exámenes por sí mismos para buscar entradas de BSS candidatas. Puede conectarse a cualquier entrada de BSS que encuentre siempre que cumpla los parámetros configurados por el host. Debe optimizar esta selección para asegurarse de que cumple los requisitos de calidad de conexión configurados. Esto podría incluir la optimización del examen de itinerancia, optimizar la selección de AP, optimizar el proceso de asociación y minimizar el protocolo de enlace de seguridad necesario. Durante un examen, si el dispositivo necesita parámetros de asociación adicionales para una entrada BSS encontrada (por ejemplo, PMKID para itinerancia), puede enviar una indicación de NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST para obtener los parámetros. Cuando esté disponible, el host configura estos parámetros con OID_WDI_SET_ASSOCIATION_PARAMETERS.

Si se produce un error en la conexión o se anula, el puerto no debe restablecer ninguna configuración que se haya configurado fuera del comando connect. Debe admitir el host que emite una segunda llamada de conexión en el mismo puerto.

El puerto debe notificar el estado del intento de conexión para cada entrada de BSS al final del intento de asociación. Esto incluye el intento correcto y también los intentos erróneos. En cualquier momento, el puerto debe estar asociado a no más de un punto de acceso o Wi-Fi Direct GO.

Mientras una conexión está en curso, el puerto debe mantener las conexiones establecidas en otros puertos (por ejemplo, Infraestructura o Wi-Fi Direct). Sin embargo, el puerto puede reducir la cantidad de acceso medio proporcionado a los otros puertos para finalizar la conexión. Durante la conexión, el host puede enviar solicitudes de envío de paquetes en otros puertos.

Si el algoritmo de autenticación que se usa para la conexión requiere la autorización de puerto 802.1x para el acceso a la red, el host autoriza el puerto después de que la operación de asociación se haya completado correctamente.

La estación 802.11 usa la memoria caché PMKID para la autenticación previa a los puntos de acceso que han habilitado el algoritmo de autenticación De asociación de red de seguridad sólida (RSNA). Si la estación 802.11 está asociando o reasociando a un BSSID que tiene un PMKID proporcionado, la estación 802.11 debe usar los datos PMKID en el elemento de información de RSN (RSN IE) de su marco Association o Reassociation.

Si el puerto declara compatibilidad con el modo FIPS de host en WDI_TLV_STATION_ATTRIBUTES, HostFIPSModeEnabled puede establecerse en 1 en los parámetros de conexión.

Si HostFIPSModeEnabled está establecido en 1, se aplican las reglas siguientes.

  • El puerto debe seguir las directrices para enviar o recibir fotogramas de datos en operaciones de envío en modo FIPS y operaciones de recepción en modo FIPS.
  • El puerto no debe declarar la compatibilidad con ningún protocolo QoS en la solicitud de asociación enviada a un punto de acceso que no sea HT. La compatibilidad con QoS es necesaria para las conexiones HT.
  • El puerto no debe negociar TSpec y no debe realizar la agregación de MSDU de transmisión.
  • El puerto debe asegurarse de que el bit compatible con A-MSDU de SPP (bit 10) de las funcionalidades de RSN que transmite está establecido en cero. Solo se admite PP A-MSDU en este modo.

Los parámetros de conexión no deben tener MFPEnabled y HostFIPSModeEnabled establecidos en 1. La protección de fotogramas de administración (802.11w) requiere que el puerto cifre o descifre determinados marcos de administración y acción, por lo que no se puede habilitar para una conexión mediante el modo FIPS de host. Además, las características de Wake on Wireless LAN no son aplicables en el modo Host-FIPS.

Parámetros de tareas

TLV Se permiten varias instancias de TLV Opcional Descripción
WDI_TLV_CONNECT_PARAMETERS Parámetros de conexión.
WDI_TLV_CONNECT_BSS_ENTRY X La lista preferida de entradas de BSS de conexión de candidatos. El puerto debe intentar conectarse a cualquiera de estas entradas de BSS hasta que la lista se agote o la conexión se complete correctamente. El puerto puede volver a escribir las entradas si es necesario. Si el adaptador ha establecido el bit Connect BSS Selection Override (Invalidación de selección de BSS de conexión), puede elegir un BSS que no esté en esta lista, siempre y cuando siga la lista Permitido/No permitido.

Indicación de finalización de tareas

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Indicación no solicitada

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

Requisitos

Cliente mínimo compatible

Windows 10

Servidor mínimo compatible

Windows Server 2016

Encabezado

 Dot11wdi.h