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 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.
Observaciones
Normalmente, los controladores de cliente llaman a WifiDeviceSetStationCapabilities dentro de EvtDevicePrepareHardware. Para obtener más información, consulte flujo de creación del adaptador predeterminado (estación).
Llame a WIFI_STATION_CAPABILITIES_INIT para inicializar la estructura WIFI_STATION_CAPABILITIES y rellenar su campo Tamaño. A continuación, llame a WifiDeviceSetStationCapabilities para informar de las funcionalidades de la estación de informes a WiFiCx.
Para indicar la capacidad de mantener conectividad secundaria de Sta, el controlador debe establecer los NumSecondaryStaBandCombinations y SecondaryStaBandsCombinations campos de la estructura 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 la MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupportedy AkmsList campos de la estructura 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 el 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 | Valor |
|---|---|
| cliente mínimo admitido | Windows 11 |
| servidor mínimo admitido | Windows Server 2022 |
| encabezado de | wificx.h |
| irQL | PASSIVE_LEVEL |