Compartir a través de

OID_WDI_TASK_START_AP (dot11wificxintf.h)

  • Artículo

Importante

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

OID_WDI_TASK_START_AP solicita que el componente IHV configure un puerto para iniciar un Wi-Fi propietario del grupo directo en el puerto especificado.

Object Abort capable (Anular capaz de anular) Prioridad predeterminada (directiva de controlador de host) Tiempo de ejecución normal (segundos)
Port Sí. La anulación debe estar seguida de un restablecimiento de punto11. 4 1

Durante la inicialización, el controlador establece la capacidad go en banda de 5 GHz en WIFI_WIFIDIRECT_CAPABILITIES para indicar si puede iniciar el punto de acceso en la banda de 5 GHz.

Si se establece la compatibilidad con la banda GO en 5 GHz, el adaptador debe iniciar el AP en el canal operativo anunciado y, si se produce un error, debe probar la lista especificada en el parámetro de lista de canales de banda AP. El sistema operativo proporcionará una sugerencia al controlador sobre si este AP proporcionaría conectividad a Internet estableciendo la marca DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED en WDI_TLV_P2P_GROUP_OWNER_CAPABILITY.

Si se especifica MustUseSpecifiedChannel en WDI_TLV_START_AP_PARAMETERS , el AP puede devolver uno de los siguientes errores si no puede iniciar el AP en la banda o canales especificados:

  • NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE: No se puede iniciar el AP en los canales especificados en este momento. Vuelva a intentarlo en los canales especificados más adelante.

  • NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE: No se puede iniciar el AP en las bandas especificadas en este momento. Vuelva a intentarlo en las bandas especificadas más adelante.

  • NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED: No se puede iniciar el AP en los canales especificados debido a motivos normativos.

  • NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED: No se puede iniciar el AP en las bandas especificadas debido a motivos normativos.

Parámetros de tareas

TLV Se permiten varias instancias de TLV Opcional Descripción
WDI_TLV_SSID SSID que va a usar el AP.
WDI_TLV_START_AP_PARAMETERS Parámetros adicionales para esta tarea.
WDI_TLV_AUTH_ALGO_LIST Lista de algoritmos de autenticación que puede usar la conexión.
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST Lista de algoritmos de cifrado de multidifusión que puede usar la conexión.
WDI_TLV_UNICAST_CIPHER_ALGO_LIST Lista de algoritmos de cifrado de multidifusión que puede usar la conexión.
WDI_TLV_P2P_CHANNEL_NUMBER X Si se especifica, define el canal operativo determinado en la formación de grupos. Esto solo se puede especificar cuando el modo operativo es Wi-Fi Direct GO.
WDI_TLV_AP_BAND_CHANNEL x X Lista opcional de bandas y canales para iniciar el punto de acceso. Si MustUseSpecifiedChannels está establecido en 1, el AP solo se puede iniciar desde esta lista. Si no se establece, esta lista está pensada para ser una recomendación de los canales de los que el firmware puede elegir, y puede elegir otro canal si no es posible iniciar el AP en cualquiera de los canales especificados.

Indicación de finalización de tareas

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Requisitos

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