DOT11EXTIHV_CONTROL 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 de DLL de Extensões IHV Dot11ExtIhvControl para permitir o controle IHV (fornecedor de hardware) independente de drivers ou serviços WLAN.

Sintaxe

DOT11EXTIHV_CONTROL Dot11extihvControl;

DWORD Dot11extihvControl(
  [in, optional]  HANDLE hIhvExtAdapter,
  [in]            DWORD dwInBufferSize,
  [in, optional]  PBYTE pInBuffer,
  [in]            DWORD dwOutBufferSize,
  [out, optional] PBYTE pOutBuffer,
  [out]           PDWORD pdwBytesReturned
)
{...}

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 tamanho, em bytes, do buffer de controle de entrada apontado pelo parâmetro pInBuffer.

[in, optional] pInBuffer

Um ponteiro para o buffer de controle de entrada.

[in] dwOutBufferSize

O tamanho, em bytes, do buffer de saída (se fornecido) apontado pelo parâmetro pOutBuffer.

[out, optional] pOutBuffer

Um ponteiro para o buffer de saída, se fornecido.

[out] pdwBytesReturned

Um ponteiro para uma variável que contém o tamanho, em bytes, do buffer de entrada/saída de resposta.

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 essa função quando a função WlanIhvControl é chamada com o parâmetro tipo definido como um valor de wlan_ihv_control_type_service. Para obter uma descrição da função WlanIhvControl, consulte a documentação do SDK do Microsoft Windows.

Os dados transferidos com essa função não são validados, portanto, o IHV é responsável por analisar corretamente o buffer de entrada.

O buffer de dados apontado pelo parâmetro pdwBytesReturned sempre será retornado. No entanto, o buffer apontado por pOutBuffer será copiado somente se um ponteiro válido for fornecido e o valor apontado por pdwBytesReturned for menor ou igual a dwOutBufferSize .

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

Dot11ExtIhvInitAdapter

Compartilhar via