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

Consulte también

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

Flujo de creación del adaptador predeterminado (estación)