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 a 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.

Commenti

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 . Chiamare quindi WifiDeviceSetStationCapabilities per segnalare le funzionalità della stazione a WiFiCx.

Per indicare la possibilità di gestire la connettività sta secondaria, il driver deve impostare i campi NumSecondaryStaBandCombinations e SecondaryStaBandsCombinations della struttura WIFI_STATION_CAPABILITIES su valori non zero. Se il valore è 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 i campi MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported e AkmsList della struttura WIFI_STATION_CAPABILITIES su valori non zero.

Per supportare le connessioni SAE usando 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 }

Requisiti

Vedi anche

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

Flusso di creazione dell'adattatore predefinito (stazione)