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

Artigo
02/07/2025

Importante A interface de lan sem fio do Nativo 802.11 é preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte do modelo de driver Universal do Windows da WLAN.

O sistema operacional chama a função Dot11ExtIhvReceivePacket para encaminhar um pacote, recebido pelo adaptador WLAN (LAN sem fio), para a DLL de Extensões IHV para processamento.

Sintaxe

DOT11EXTIHV_RECEIVE_PACKET Dot11extihvReceivePacket;

DWORD Dot11extihvReceivePacket(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DWORD dwInBufferSize,
  [in]           LPVOID pvInBuffer
)
{...}

Parâmetros

[in, optional] hIhvExtAdapter

O identificador usado pela DLL de Extensões IHV para referenciar o adaptador WLAN. Esse valor de identificador foi especificado por meio de uma chamada anterior para a função Dot11ExtIhvInitAdapter manipulador IHV.

[in] dwInBufferSize

O comprimento, em bytes, do pacote recebido referenciado pelo parâmetro pvInBuffer.

[in] pvInBuffer

Um ponteiro para um buffer, alocado pelo sistema operacional, que contém os dados do pacote, conforme descrito na seção Comentários.

Valor de retorno

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.

Observações

O sistema operacional chama a função Dot11ExtIhvReceivePacket quando ocorre o seguinte:

O adaptador WLAN recebe um pacote e o driver de miniporto Nativo 802.11, que gerencia o adaptador, indica o pacote para o sistema operacional.
O IEEE EtherType do pacote corresponde a uma entrada na lista de EtherTypes especificada pela DLL de Extensões IHV por meio de uma chamada para o função Dot11ExtSetEtherTypeHandling.

O buffer apontado por pvPacket deve conter os seguintes dados de pacote, especificados na ordem de bytes de rede:

Endereço MAC de destino (6 bytes), formatado de acordo com as diretrizes discutidas no 802.11 MAC Header Management
EtherType IEEE (2 bytes)
Carga útil

Requisitos

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

Consulte também

Dot11ExtSetEtherTypeHandling

Dot11ExtIhvInitAdapter

Partilhar via