Funzione WifiDeviceSetStationCapabilities (wificx.h)
La funzione WifiDeviceSetStationCapabilities imposta le funzionalità della stazione per un dispositivo WiFiCx.
Sintassi
NTSTATUS WifiDeviceSetStationCapabilities(
WDFDEVICE Device,
const WIFI_STATION_CAPABILITIES *StationCapabilities
);
Parametri
Device
Handle per un oggetto dispositivo framework il driver client ottenuto da una chiamata precedente a WdfDeviceCreate.
StationCapabilities
Puntatore a una struttura del driver client allocata e inizializzata WIFI_STATION_CAPABILITIES.
Valore restituito
Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione può restituire un codice di errore NTSTATUS appropriato.
Osservazioni
I driver client chiamano in genere WifiDeviceSetStationCapabilities all'interno di EvtDevicePrepareHardware. Per altre informazioni, vedere flusso di creazione dell'adattatore predefinito (stazione).
Chiamare WIFI_STATION_CAPABILITIES_INIT per inizializzare la struttura WIFI_STATION_CAPABILITIES e compilare il relativo campo dimensioni. Chiama quindi WifiDeviceSetStationCapabilities per segnalare le funzionalità della stazione a WiFiCx.
Per indicare la possibilità di mantenere di connettività sta secondaria, il driver deve impostare i campi NumSecondaryStaBandCombintions e SecondaryStaBandsCombintions campi della struttura WIFI_STATION_CAPABILITIES su valori diversi da zero. Se uno dei due valori è 0 o NULL, la funzionalità Sta secondaria non verrà impostata.
Per indicare il supporto per le connessioni MLO in Wi-Fi 7, il driver deve impostare il MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupportede campi AkmsList della struttura WIFI_STATION_CAPABILITIES su valori diversi da zero.
Per supportare le connessioni SAE tramite AKM 24 o AKM 8 con crittografia GCMP-256, il driver deve aggiungere le coppie di crittografia di autenticazione seguenti nella struttura WIFI_STATION_CAPABILITIES:
- In UnicastAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
- In MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
Per supportare le connessioni OWE con crittografia GCMP-256, il driver deve aggiungere la coppia di crittografia di autenticazione seguente:
- In UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 11 |
| server minimo supportato | Windows Server 2022 |
| intestazione | wificx.h |
| IRQL | PASSIVE_LEVEL |