Função WifiDeviceSetStationCapabilities (wificx.h)
A função WifiDeviceSetStationCapabilities define os recursos da estação para um dispositivo WiFiCx.
Sintaxe
NTSTATUS WifiDeviceSetStationCapabilities(
WDFDEVICE Device,
const WIFI_STATION_CAPABILITIES *StationCapabilities
);
Parâmetros
Device
Um identificador para um objeto de dispositivo de estrutura que o driver cliente obteve de uma chamada anterior para WdfDeviceCreate.
StationCapabilities
Um ponteiro para uma estrutura de WIFI_STATION_CAPABILITIES alocada e inicializada pelo driver do cliente.
Valor de retorno
Retorna STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função poderá retornar um código de erro NTSTATUS apropriado.
Observações
Os drivers cliente normalmente chamam WifiDeviceSetStationCapabilities dentro EvtDevicePrepareHardware . Para obter mais informações, consulte fluxo de criação do adaptador padrão (estação).
Chame WIFI_STATION_CAPABILITIES_INIT para inicializar a estrutura de WIFI_STATION_CAPABILITIES e preencher seu campo tamanho. Em seguida, chame WifiDeviceSetStationCapabilities para relatar os recursos da estação para WiFiCx.
Para indicar a capacidade de manter de conectividade do Sta Secundário, o driver deve definir os campos NumSecondaryStaBandCombinations e SecondaryStaBandsCombinations campos da estrutura WIFI_STATION_CAPABILITIES para valores não zero. Se um dos valores for 0 ou NULL, a funcionalidade do Sta Secundário não será definida.
Para indicar suporte para conexões MLO no Wi-Fi 7, o driver deve definir os campos MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupportede AkmsList da estrutura WIFI_STATION_CAPABILITIES para valores não zero.
Para dar suporte a conexões SAE usando AKM 24 ou AKM 8 com criptografia GCMP-256, o driver deve adicionar os seguintes pares de criptografia de autenticação na estrutura WIFI_STATION_CAPABILITIES:
- No UnicastAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
- No MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
Para dar suporte a conexões OWE com criptografia GCMP-256, o driver deve adicionar o seguinte par de criptografia de autenticação:
- Em UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 11 |
| servidor com suporte mínimo | Windows Server 2022 |
| cabeçalho | wificx.h |
| IRQL | PASSIVE_LEVEL |