Partager via

OID_WDI_TASK_START_AP (dot11wificxintf.h)

  • Article

Important

Cette rubrique fait partie du modèle de pilote WiFiCx. 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. Le modèle de pilote WDI Wi-Fi précédent est en mode maintenance et ne reçoit que des correctifs de priorité élevée.

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 Abandonner la capacité Priorité par défaut (stratégie du pilote hôte) Temps d’exécution normal (secondes)
Port Oui. L’abandon doit être suivi d’une réinitialisation dot11. 4 1

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

Si go sur la bande 5 GHz prise en charge 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 bande AP. Le système d’exploitation fournit au pilote un indicateur indiquant 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 bande/canal(s) spécifiée(s) :

  • NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE : Impossible de démarrer l’AP sur le ou les canaux spécifiés pour l’instant. 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 Si elle est spécifiée, cela définit le canal d’exploitation déterminé dans la formation de 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 Liste facultative de bandes et de canaux sur 1000 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 parmi lequel 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 l’achèvement de la tâche

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 11
Serveur minimal pris en charge Windows Server 2022
En-tête dot11wificxintf.h