OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Importante

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

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

Object	Anulación compatible	Prioridad predeterminada (directiva de controlador de host)	Ejecución normal (segundos)
Port	Sí. La anulación debe ir seguida de un restablecimiento de punto11.	4	10

Como parte de la conexión, el componente de IHV debe sincronizarse, autenticarse en 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 puede conectarse a cualquiera de las entradas de BSS, debe completar el proceso de conexión con un error.

El componente IHV no necesita realizar un análisis para buscar entradas de BSS candidatas. Puede usar la lista proporcionada por el host para la conexión. Puede intentar conectarse a cada una, una después de otra. El host ordena las redes por RSSI, pero el componente IHV puede usar su propio orden de conexión. Si el adaptador no especifica "Invalidación de selección de conexión de BSS", 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 "Invalidación de selección de conexión de BSS", puede realizar análisis por sí mismo para buscar entradas 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 análisis de desplazamiento, optimizar la selección de AP, optimizar el proceso de asociación y minimizar el protocolo de enlace de seguridad necesario. Durante un análisis, 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 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 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 WIFI_STATION_CAPABILITIES, 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 instrucciones para enviar o recibir secuencias de datos en operaciones de envío en modo FIPS y operaciones de recepción en modo FIPS.
• El puerto no debe declarar 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 SPP A-MSDU (bit 10) de las funcionalidades de RSN que transmite se establece en cero. Solo se admiten 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 marcos de administración (802.11w) requiere que el puerto cifre o descifre ciertos 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.

Requisitos de WiFi 7/MLO

Windows proporciona el parámetro MloConnectionSupported en WDI_TLV_CONNECTION_SETTINGS que indica si el controlador puede conectarse mediante MLO. Cuando se conecta a una red segura, el controlador solo puede usar los pares AKM y cifrado especificados en WDI_TLV_RSNA_AKM_CIPHER_SUITE. La única excepción es si la autenticación o cifrado no forma parte del IE de RSNA.

Para obtener más información, consulte Requisitos de características de Wi-Fi 7 de WiFiCx.

Parámetros de tareas

TLV	Se permiten varias instancias de TLV	Opcionales	Descripción
WDI_TLV_CONNECT_PARAMETERS			Los parámetros de conexión.
WDI_TLV_CONNECT_BSS_ENTRY	X		La lista preferida de entradas de BSS de conexión candidatas. El puerto debe intentar conectarse a cualquiera de estas entradas de BSS hasta que se agote la lista o la conexión se complete correctamente. El puerto puede volver a priorizar las entradas si es necesario. Si el adaptador ha establecido el bit de invalidación de selección de conexión de BSS, puede elegir una BSS que no se encuentre en esta lista siempre y cuando siga la lista de Permitidos/No permitidos.

Indicación de finalización de tarea

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

Requisito	Valor
Cliente mínimo compatible	Windows 11
Servidor mínimo compatible	Windows Server 2022
Encabezado	dot11wificxintf.h