DOT11EXTIHV_CONTROL 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.
 
O sistema operacional chama a função DLL Dot11ExtIhvControl das Extensões IHV para permitir o controle IHV (fornecedor independente de hardware) 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 manipulador IHV Dot11ExtIhvInitAdapter .

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

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

O sistema operacional chama essa função quando a função WlanIhvControl é chamada com o parâmetro Type 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
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

Dot11ExtIhvInitAdapter