DOT11EXT_ALLOCATE_BUFFER 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 Dot11ExtAllocateBuffer para alocar memória para buffers de comprimento variável.

Sintaxe

DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;

DWORD Dot11extAllocateBuffer(
  [in]  DWORD dwByteCount,
  [out] LPVOID *ppvBuffer
)
{...}

Parâmetros

[in] dwByteCount

Tamanho, em bytes, do buffer a ser alocado.

[out] ppvBuffer

Um ponteiro para uma variável fornecida pelo chamador que armazena o endereço do buffer alocado. O parâmetro ppvBuffer terá um valor não nulo válido se o valor retornado for ERROR_SUCCESS.

Retornar valor

A chamada retorna um código ERROR_xxxx definido em Winerror.h. Os seguintes códigos de ERROR_xxxx normalmente são retornados pela função Dot11ExtAllocateBuffer .

Código de retorno Descrição
ERROR_SUCCESS
 A chamada foi bem-sucedida sem um erro.
ERROR_OUTOFMEMORY
 O sistema operacional não pôde alocar a memória devido à falta de recursos.

Comentários

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

  • A DLL de Extensões IHV deve chamar essa função ao retornar qualquer buffer de comprimento variável de uma função de manipulador IHV. Nessa situação, o sistema operacional é responsável por liberar o buffer após o retorno da função manipulador IHV.

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

  • A DLL de Extensões IHV pode chamar essa função para alocar memória referenciada pela própria DLL.

    Nessa situação, a DLL deve liberar o buffer de memória chamando Dot11ExtFreeBuffer.

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

Dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer