DOT11EXT_SET_ETHERTYPE_HANDLING função de retorno de chamada (wlanihv.h)

Artigo
02/27/2024

Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.

A DLL de Extensões IHV chama a função Dot11ExtSetEtherTypeHandling para fazer o seguinte:

Configure o adaptador WLAN (LAN sem fio) com uma lista de isenções de descriptografia de pacotes. Cada isenção é aplicada com base no EtherType IEEE do pacote recebido.
Registre-se no sistema operacional para os EtherTypes de pacotes recebidos que serão encaminhados para a DLL de Extensões IHV por meio de chamadas para a função manipulador IHV Dot11ExtIhvReceivePacket .

Sintaxe

DOT11EXT_SET_ETHERTYPE_HANDLING Dot11extSetEthertypeHandling;

DWORD Dot11extSetEthertypeHandling(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uMaxBackLog,
  [in]           ULONG uNumOfExemption,
  [in, optional] PDOT11_PRIVACY_EXEMPTION pExemption,
  [in]           ULONG uNumOfRegistration,
  [in, optional] USHORT *pusRegistration
)
{...}

Parâmetros

[in, optional] hDot11SvcHandle

O identificador usado pelo sistema operacional para fazer referência ao adaptador WLAN. Esse valor de identificador foi especificado por meio de uma chamada anterior para a função Manipulador IHV Dot11ExtIhvInitAdapter .

[in] uMaxBackLog

O número máximo de pacotes recebidos que o sistema operacional enfileira se a DLL de Extensões IHV não tiver retornado de uma chamada para a função Manipulador IHV Dot11ExtIhvReceivePacket . Quando uMaxBackLog é atingido, o sistema operacional descarta o pacote mais antigo na fila.

[in] uNumOfExemption

O número de entradas na matriz de isenções de privacidade referenciada pelo parâmetro pExemption . Um valor zero desabilita as isenções de privacidade no adaptador WLAN.

[in, optional] pExemption

Um ponteiro para uma matriz de isenções de privacidade. Cada entrada na matriz é formatada como um DOT11_PRIVACY_EXEMPTION estrutura.

[in] uNumOfRegistration

Número de entradas na matriz de registros EtherType do IEEE referenciada pelo parâmetro pusRegistration . Um valor zero desabilita a capacidade da DLL de Extensões IHV de receber pacotes por meio de chamadas para a função Manipulador IHV Dot11ExtIhvReceivePacket .

[in, optional] pusRegistration

Um ponteiro para uma matriz de registros IEEE EtherType. Cada entrada tem o valor EtherType no formato big-endian.

Retornar valor

Se a chamada for bem-sucedida, a função retornará ERROR_SUCCESS. Caso contrário, ele retornará um código de erro definido em Winerror.h.

Comentários

Ao chamar a função Dot11ExtSetEtherTypeHandling , a DLL de Extensões IHV deve seguir estas diretrizes:

A DLL de Extensões IHV pode chamar Dot11ExtSetEtherTypeHandling de dentro das chamadas para Dot11ExtIhvInitAdapter ou Dot11ExtIhvPerformPreAssociate Funções do Manipulador IHV.
A DLL de Extensões IHV não deve chamar Dot11ExtSetEtherTypeHandling depois de concluir com êxito a operação de pré-associação por meio de uma chamada para Dot11ExtPreAssociateCompletion.

O sistema operacional usa como padrão uma lista vazia de isenções de privacidade e registros EtherType antes da chamada da função Manipulador IHV Dot11ExtIhvInitAdapter .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	wlanihv.h (inclua Wlanihv.h)