OID_WDI_TASK_START_AP

Importante

Questo argomento fa parte del modello di driver WDI rilasciato in Windows 10. Il modello di driver WDI è in modalità di manutenzione e riceverà solo correzioni con priorità elevata. WiFiCx è il modello di driver Wi-Fi rilasciato in Windows 11. È consigliabile usare WiFiCx per sfruttare le funzionalità più recenti.

OID_WDI_TASK_START_AP richiede che il componente IHV configura una porta per avviare un Wi-Fi proprietario del gruppo diretto sulla porta specificata.

Oggetto	Interruzione in grado di eseguire l'interruzione	Priorità predefinita (criteri del driver host)	Tempo di esecuzione normale (secondi)
Porta	Sì. L'interruzione deve essere seguita da una reimpostazione dot11.	4	1

Durante l'inizializzazione, il driver imposta la funzionalità GO sulla banda 5GHz in WDI_TLV_P2P_CAPABILITIES per indicare se può avviare il punto di accesso sulla banda 5 GHz.

Se è impostato il supporto della banda 5 GHz, l'adattatore deve avviare l'API nel canale Operativo annunciato e, se non riesce, dovrebbe provare l'elenco specificato nel parametro elenco di canali della banda AP. Il sistema operativo fornisce un suggerimento per il driver su se questa AP fornirebbe la connettività Internet impostando il flag di DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED in WDI_TLV_P2P_GROUP_OWNER_CAPABILITY.

Se mustUseSpecifiedChannel in WDI_TLV_START_AP_PARAMETERS viene specificato, l'API può restituire uno degli errori seguenti se non è in grado di avviare l'API nelle band/canali specificati.

NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE: non è possibile avviare l'API nel canale specificato al momento. Ripetere i tentativi nei canali specificati in un secondo momento.

NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE: non è possibile avviare l'API nelle bande specificate al momento. Ripetere i tentativi nelle bande specificate in un secondo momento.

NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED: impossibile avviare l'API nei canali specificati a causa di motivi normativi.

NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED: impossibile avviare l'AP nelle bande specificate a causa di motivi normativi.

Parametri dell'attività

TLV	Più istanze TLV consentite	Facoltativo	Descrizione
WDI_TLV_SSID			SSID da usare dall'AP.
WDI_TLV_START_AP_PARAMETERS			Parametri aggiuntivi per questa attività.
WDI_TLV_AUTH_ALGO_LIST			Elenco degli algoritmi di autenticazione che la connessione può usare.
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST			Elenco di algoritmi di crittografia multicast che la connessione può usare.
WDI_TLV_UNICAST_CIPHER_ALGO_LIST			Elenco di algoritmi di crittografia multicast che la connessione può usare.
WDI_TLV_P2P_CHANNEL_NUMBER		X	Se specificato, questo definisce il canale operativo determinato nella formazione del gruppo. Questa opzione può essere specificata solo quando la modalità operativa è Wi-Fi Direct GO.
WDI_TLV_AP_BAND_CHANNEL	X	X	Aggiunta in Windows 10 versione 1511, WDI versione 1.0.10. Elenco facoltativo di bande e canali per avviare il punto di accesso. Se MustUseSpecifiedChannels è impostato su 1, l'API può essere avviata solo da questo elenco. Se non è impostato, questo elenco è destinato a essere una raccomandazione di canali che il firmware può scegliere e può scegliere un altro canale se non è possibile avviare l'API in uno dei canali specificati.

Indicazione del completamento dell'attività

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Requisiti

Client minimo supportato	Windows 10
Server minimo supportato	Windows Server 2016
Intestazione	Dot11wdi.h