Fonction WifiDeviceSetStationCapabilities (wificx.h)
La fonction WifiDeviceSetStationCapabilities définit les fonctionnalités de station pour un appareil WiFiCx.
Syntaxe
NTSTATUS WifiDeviceSetStationCapabilities(
WDFDEVICE Device,
const WIFI_STATION_CAPABILITIES *StationCapabilities
);
Paramètres
Device
Handle pour un objet d’appareil d’infrastructure que le pilote client a obtenu à partir d’un appel précédent à WdfDeviceCreate.
StationCapabilities
Pointeur vers une structure de WIFI_STATION_CAPABILITIES allouée et initialisée par le pilote client.
Valeur retournée
Retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette fonction peut retourner un code d’erreur NTSTATUS approprié.
Remarques
Les pilotes clients appellent généralement WifiDeviceSetStationCapabilities dans EvtDevicePrepareHardware. Pour plus d’informations, consultez Flux de création d’adaptateur (station) par défaut.
Appelez WIFI_STATION_CAPABILITIES_INIT pour initialiser la structure WIFI_STATION_CAPABILITIES et remplir son champ Taille . Appelez ensuite WifiDeviceSetStationCapabilities pour signaler les fonctionnalités de la station à WiFiCx.
Pour indiquer la capacité à maintenir la connectivité d’sta secondaire, le pilote doit définir les champs NumSecondaryStaBandCombinations et SecondaryStaBandsCombinations de la structure WIFI_STATION_CAPABILITIES sur des valeurs non nulles. Si la valeur est 0 ou NULL, la fonctionnalité d’authentification secondaire n’est pas définie.
Pour indiquer la prise en charge des connexions MLO dans Wi-Fi 7, le pilote doit définir les champs MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported et AkmsList de la structure WIFI_STATION_CAPABILITIES sur des valeurs non nulles.
Pour prendre en charge les connexions SAE à l’aide d’AKM 24 ou AKM 8 avec le chiffrement GCMP-256, le pilote doit ajouter les paires d’authentification-chiffrement suivantes dans la structure WIFI_STATION_CAPABILITIES :
- Dans UnicastAlgorithmsList : { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
- Dans MulticastMgmtAlgorithmsList : { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
Pour prendre en charge les connexions OWE avec le chiffrement GCMP-256, le pilote doit ajouter la paire auth-chiffrement suivante :
- Dans UnicastAlgorithmsList : { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 11 |
| Serveur minimal pris en charge | Windows Server 2022 |
| En-tête | wificx.h |
| IRQL | PASSIVE_LEVEL |