Condividi tramite

OID_WDI_TASK_START_AP (dot11wificxintf.h)

  • Articolo

Importante

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

OID_WDI_TASK_START_AP richiede che il componente IHV configuri 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 a 5 GHz in WIFI_WIFIDIRECT_CAPABILITIES per indicare se può avviare il punto di accesso sulla banda a 5 GHz.

Se è impostato il supporto della banda GO a 5 GHz, l'adattatore deve avviare l'API nel canale operativo annunciato e, in caso di errore, dovrebbe provare l'elenco specificato nel parametro dell'elenco dei canali della banda AP. Il sistema operativo fornirà un suggerimento al driver per stabilire se questa API fornirà la connettività Internet impostando il flag 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 nella banda/canale specificato:

  • NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE: impossibile avviare l'API nei canali specificati al momento. Riprovare sui canali specificati in un secondo momento.

  • NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE: impossibile avviare l'API nelle bande specificate al momento. Riprovare sulle 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'API nelle bande specificate a causa di motivi normativi.

Parametri dell'attività

TLV Sono consentite più istanze TLV Facoltativo Descrizione
WDI_TLV_SSID SSID da usare dall'API.
WDI_TLV_START_AP_PARAMETERS Parametri aggiuntivi per questa attività.
WDI_TLV_AUTH_ALGO_LIST Elenco di 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, 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 Elenco facoltativo di bande e canali in cui 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 di completamento attività

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Requisiti

Requisito Valore
Client minimo supportato Windows 11
Server minimo supportato Windows Server 2022
Intestazione dot11wificxintf.h