OID_WDI_TASK_START_AP

Important

Cette rubrique fait partie du modèle de pilote WDI publié dans Windows 10. Le modèle de pilote WDI est en mode maintenance et ne reçoit que des correctifs de priorité élevée. WiFiCx est le modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

OID_WDI_TASK_START_AP demande que le composant IHV configure un port pour démarrer un Wi-Fi propriétaire de groupe direct sur le port spécifié.

Object	Capacité d’abandon	Priorité par défaut (stratégie de pilote hôte)	Temps d’exécution normal (secondes)
Port	Oui. L’abandon doit être suivi d’une réinitialisation point11.	4	1

Lors de l’initialisation, le pilote définit la fonctionnalité GO sur la bande 5 GHz dans WDI_TLV_P2P_CAPABILITIES pour indiquer s’il peut démarrer le point d’accès sur la bande de 5 GHz.

Si la prise en charge de GO sur la bande 5 GHz est définie, l’adaptateur doit démarrer l’AP sur le canal d’exploitation publié, et si cela échoue, il doit essayer la liste spécifiée dans le paramètre de liste des canaux de la bande AP. Le système d’exploitation indique au pilote si ce point d’accès fournit une connectivité Internet en définissant l’indicateur DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED dans WDI_TLV_P2P_GROUP_OWNER_CAPABILITY.

Si MustUseSpecifiedChannel dans WDI_TLV_START_AP_PARAMETERS est spécifié, l’AP peut retourner l’une des erreurs suivantes s’il ne parvient pas à démarrer l’AP sur la ou les bandes/canaux spécifiés.

NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE : Impossible de démarrer l’AP sur le ou les canaux spécifiés pour le moment. Réessayez ultérieurement sur le ou les canaux spécifiés.

NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE : Impossible de démarrer l’AP sur la ou les bandes spécifiées pour le moment. Réessayez ultérieurement sur la ou les bandes spécifiées.

NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED : Impossible de démarrer l’AP sur le ou les canaux spécifiés pour des raisons réglementaires.

NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED : Impossible de démarrer l’AP sur la ou les bandes spécifiées pour des raisons réglementaires.

Paramètres de tâche

TLV	Plusieurs instances TLV autorisées	Facultatif	Description
WDI_TLV_SSID			SSID à utiliser par l’AP.
WDI_TLV_START_AP_PARAMETERS			Paramètres supplémentaires pour cette tâche.
WDI_TLV_AUTH_ALGO_LIST			Liste des algorithmes d’authentification que la connexion peut utiliser.
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST			Liste des algorithmes de chiffrement de multidiffusion que la connexion peut utiliser.
WDI_TLV_UNICAST_CIPHER_ALGO_LIST			Liste des algorithmes de chiffrement de multidiffusion que la connexion peut utiliser.
WDI_TLV_P2P_CHANNEL_NUMBER		X	S’il est spécifié, cela définit le canal d’exploitation déterminé dans la formation du groupe. Cela ne peut être spécifié que lorsque le mode de fonctionnement est Wi-Fi Direct GO.
WDI_TLV_AP_BAND_CHANNEL	X	X	Ajout dans Windows 10, version 1511, WDI version 1.0.10. Liste facultative des bandes et des canaux sur 2000 pour démarrer le point d’accès. Si MustUseSpecifiedChannels a la valeur 1, le point d’accès ne peut être démarré qu’à partir de cette liste. Si elle n’est pas définie, cette liste est destinée à être une recommandation de canaux que le microprogramme peut choisir, et elle peut choisir un autre canal s’il n’est pas possible de démarrer l’AP sur l’un des canaux spécifiés.

Indication de fin de tâche

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Configuration requise

Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
En-tête	Dot11wdi.h