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

  • Artigo
Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte 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 referenciar o adaptador WLAN. Esse valor de identificador foi especificado por meio de uma chamada anterior para a função manipulador IHV Dot11ExtIhvInitAdapter .

[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 IHV por meio de uma chamada para o Dot11ExtIhvSendPacketCompletion Função manipulador IHV. Ao fazer essa chamada, o sistema operacional passa o valor do identificador do pacote pelo parâmetro hSendCompletion .

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

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

  • O pacote enviado por meio de uma chamada da função Dot11ExtSendPacket será concluído de forma assíncrona. A DLL de Extensões IHV não deve liberar a memória referenciada pelo parâmetro pvPacket até o Dot11ExtIhvSendPacketCompletion A função 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 como 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 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:

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

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)

Confira também

Funções nativas do manipulador IHV 802.11

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

802.11 Gerenciamento de Cabeçalho MAC