Функция 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 |