DOT11EXT_SEND_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.

A DLL de Extensões IHV chama a função Dot11ExtSendPacket para transmitir um pacote por meio do adaptador WLAN (LAN sem fio).

Sintaxe

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

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 Dot11ExtIhvInitAdapter manipulador IHV.

[in] uPacketLen

O comprimento, em bytes, do buffer alocado pelo chamador referenciado pelo parâmetro pvPacket.

[in] pvPacket

Um ponteiro para um buffer alocado pelo chamador que contém os dados a serem transmitidos, conforme descrito na seção Comentários.

[in, optional] hSendCompletion

Um valor de identificador que identifica exclusivamente o pacote de envio.

Quando o adaptador WLAN conclui a operação de envio, o sistema operacional notifica a DLL de Extensões de IHV por meio de uma chamada para o função Dot11ExtIhvSendPacketCompletion manipulador IHV. Ao fazer essa chamada, o sistema operacional passa o valor do identificador do pacote pelo parâmetro hSendCompletion.

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

A DLL de Extensões IHV deve seguir essas diretrizes ao chamar a função do Dot11ExtSendPacket.

O pacote enviado por meio de uma chamada da função Dot11ExtSendPacket será concluída de forma assíncrona. A DLL de Extensões IHV não deve liberar a memória referenciada pelo parâmetro pvPacket até o função Dot11ExtIhvSendPacketCompletion manipulador IHV é chamada com o mesmo valor de identificador que o parâmetro hSendCompletion.
A DLL de Extensões IHV deve definir o parâmetro hSendCompletion para um valor que identifique exclusivamente os dados do pacote referenciados pelo parâmetro pvPacket.

Para obter mais informações sobre as funções do Manipulador de IHV, consulte funções de manipulador IHV nativas 802.11.

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

Esses dados de pacote são passados para o driver de miniporto.

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

funções nativas do manipulador IHV 802.11

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

de gerenciamento de cabeçalho MAC 802.11

Compartilhar via