Função WifiDeviceSetStationCapabilities (wificx.h)

A função WifiDeviceSetStationCapabilities define os recursos de 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.

Retornar valor

Retorna STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função pode retornar um código de erro NTSTATUS apropriado.

Comentários

Os drivers cliente normalmente chamam WifiDeviceSetStationCapabilities dentro de 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 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 a conectividade do Secondary Sta, o driver deve definir os campos NumSecondaryStaBandCombinations e SecondaryStaBandsCombinations da estrutura WIFI_STATION_CAPABILITIES como valores diferentes de zero. Se um dos valores for 0 ou NULL, o recurso Está Secundário não será definido.

Para indicar suporte para conexões MLO no Wi-Fi 7, o driver deve definir os campos MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported e AkmsList da estrutura WIFI_STATION_CAPABILITIES como valores diferentes de 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 :

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

Para dar suporte a conexões OWE com a 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
Cliente mínimo com suporte	Windows 11
Servidor mínimo com suporte	Windows Server 2022
Cabeçalho	wificx.h
IRQL	PASSIVE_LEVEL

Confira também

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

Fluxo de criação do adaptador padrão (estação)