Поделиться через

Функция WifiDeviceSetStationCapabilities (wificx.h)

  • Статья

Функция WifiDeviceSetStationCapabilities задает возможности станции для устройства WiFiCx.

Синтаксис

NTSTATUS WifiDeviceSetStationCapabilities(
  WDFDEVICE                       Device,
  const WIFI_STATION_CAPABILITIES *StationCapabilities
);

Параметры

Device

Дескриптор объекта устройства платформы, полученный драйвером клиента при предыдущем вызове WdfDeviceCreate.

StationCapabilities

Указатель на структуру, выделенную драйвером клиента и инициализированную WIFI_STATION_CAPABILITIES .

Возвращаемое значение

Возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта функция может вернуть соответствующий код ошибки NTSTATUS.

Комментарии

Клиентские драйверы обычно вызывают WifiDeviceSetStationCapabilities в EvtDevicePrepareHardware. Дополнительные сведения см. в разделе Поток создания адаптера по умолчанию (станции).

Вызовите WIFI_STATION_CAPABILITIES_INIT , чтобы инициализировать структуру WIFI_STATION_CAPABILITIES и заполнить ее поле Размер . Затем вызовите WifiDeviceSetStationCapabilities , чтобы сообщить о возможностях станции в WiFiCx.

Чтобы указать возможность поддерживать дополнительное подключение Sta, драйвер должен задать для полей NumSecondaryStaBandCombinations и SecondaryStaBandsCombinations структуры WIFI_STATION_CAPABILITIES значения, отличные от нуля. Если любое из значений равно 0 или NULL, возможность вторичного ста не будет задана.

Чтобы указать поддержку MLO-подключений в Wi-Fi 7, драйвер должен задать для полей MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported и AkmsList структуры WIFI_STATION_CAPABILITIES ненулевыми значениями.

Для поддержки подключений SAE с использованием AKM 24 или AKM 8 с шифром GCMP-256 драйвер должен добавить следующие пары шифров проверки подлинности в структуру WIFI_STATION_CAPABILITIES :

  • В UnicastAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
  • В MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }

Для поддержки подключений OWE с шифром GCMP-256 драйвер должен добавить следующую пару проверки подлинности и шифра:

  • В UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }

Требования

Требование Значение
Минимальная версия клиента Windows 11
Минимальная версия сервера Windows Server 2022
Верхняя часть wificx.h
IRQL PASSIVE_LEVEL

См. также раздел

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

Поток создания адаптера (станции) по умолчанию