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 Wi-Fi précédent WDI 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 propriétaire de groupe direct Wi-Fi sur le port spécifié.

Objet Abandon capable 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 dot11. 4 1

Lors de 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 la prise en charge de la bande go sur 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 de canaux de bande AP. Le système d’exploitation fournit un indicateur au pilote pour savoir si cette API fournirait une connectivité Internet en définissant l’indicateur de 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’API peut renvoyer l’une des erreurs suivantes s’il ne parvient pas à démarrer l’API sur la ou les chaînes spécifiées :

  • NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE: Impossible de démarrer l’API 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’API sur la ou les bandes spécifiées pour l’instant. Réessayez sur la ou les bandes spécifiées ultérieurement.

  • NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED: Impossible de démarrer l’API sur le ou les canaux spécifiés en raison de raisons réglementaires.

  • NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED: impossible de démarrer l’API sur la ou les bandes spécifiées en raison de raisons réglementaires.

Paramètres de tâche

TLV Plusieurs instances TLV autorisées Optionnel 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 multidiffusion que la connexion peut utiliser.
WDI_TLV_UNICAST_CIPHER_ALGO_LIST Liste des algorithmes de chiffrement 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 peut uniquement être spécifié lorsque le mode d’exploitation est Wi-Fi Direct GO.
WDI_TLV_AP_BAND_CHANNEL X X Liste facultative de bandes et de canaux pour démarrer le point d’accès. Si MustUseSpecifiedChannels est défini sur 1, l’API ne peut être démarrée qu’à partir de cette liste. S’il n’est pas défini, cette liste est destinée à être une recommandation de canaux à partir duquel le microprogramme peut choisir, et il peut choisir un autre canal s’il n’est pas possible de démarrer l’API sur l’un des canaux spécifiés.

Indication de l’achèvement de la tâche

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Exigences

Exigence Valeur
Client minimum pris en charge Windows 11
Serveur minimum pris en charge Windows Server 2022
En-tête dot11wificxintf.h