Función WifiDeviceSetStationCapabilities (wificx.h)
La función WifiDeviceSetStationCapabilities establece las funcionalidades de la estación para un dispositivo WiFiCx.
Sintaxis
NTSTATUS WifiDeviceSetStationCapabilities(
WDFDEVICE Device,
const WIFI_STATION_CAPABILITIES *StationCapabilities
);
Parámetros
Device
Identificador de un objeto de dispositivo de marco que el controlador cliente obtuvo de una llamada anterior a WdfDeviceCreate.
StationCapabilities
Puntero a una estructura de WIFI_STATION_CAPABILITIES asignada por el controlador de cliente e inicializada.
Valor devuelto
Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función puede devolver un código de error NTSTATUS adecuado.
Comentarios
Los controladores de cliente suelen llamar a WifiDeviceSetStationCapabilities dentro de EvtDevicePrepareHardware. Para obtener más información, vea Flujo de creación de adaptadores predeterminados (estación).
Llame a WIFI_STATION_CAPABILITIES_INIT para inicializar la estructura WIFI_STATION_CAPABILITIES y rellenar su campo Tamaño . A continuación, llama a WifiDeviceSetStationCapabilities para informar de las funcionalidades de la estación de informes a WiFiCx.
Para indicar la capacidad de mantener la conectividad secundaria sta, el controlador debe establecer los campos NumSecondaryStaBandCombinations y SecondaryStaBandsCombinations de la estructura de WIFI_STATION_CAPABILITIES en valores distintos de cero. Si cualquiera de los valores es 0 o NULL, no se establecerá la funcionalidad Sta secundaria.
Para indicar la compatibilidad con las conexiones MLO en Wi-Fi 7, el controlador debe establecer los campos MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported y AkmsList de la estructura de WIFI_STATION_CAPABILITIES en valores distintos de cero.
Para admitir conexiones SAE mediante AKM 24 o AKM 8 con cifrado GCMP-256, el controlador debe agregar los siguientes pares de cifrado de autenticación en la estructura de WIFI_STATION_CAPABILITIES :
- En UnicastAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
- En MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
Para admitir conexiones OWE con cifrado GCMP-256, el controlador debe agregar el siguiente par de cifrado de autenticación:
- En UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11 |
| Servidor mínimo compatible | Windows Server 2022 |
| Encabezado | wificx.h |
| IRQL | PASSIVE_LEVEL |