DOT11EXTIHV_INIT_SERVICE 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 Dot11ExtIhvInitService para inicializar a DLL de Extensões IHV, bem como a interface de API entre o sistema operacional e a DLL.

Sintaxe

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

DWORD Dot11extihvInitService(
  [in]  DWORD dwVerNumUsed,
  [in]  PDOT11EXT_APIS pDot11ExtAPI,
        LPVOID pvReserved,
  [out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}

Parâmetros

[in] dwVerNumUsed

A versão da interface usada pelo sistema operacional. O valor desse parâmetro deve estar entre os intervalos de números de versão retornados no parâmetro pDot11IHVVersionInfo do Dot11ExtIhvGetVersionInfo Função manipulador IHV.

[in] pDot11ExtAPI

Um ponteiro para uma estrutura DOT11EXT_APIS , que contém os endereços das funções de extensibilidade IHV compatíveis com o sistema operacional. O sistema operacional formata esse parâmetro com os endereços de função antes de fazer a chamada para a função Dot11ExtIhvInitService .

pvReserved

Esse parâmetro é reservado para uso pelo sistema operacional.

[out] pDot11IHVHandlers

Um ponteiro para uma estrutura de DOT11EXT_IHV_HANDLERS , que contém os endereços das funções do Manipulador IHV compatíveis com a DLL de Extensões IHV. A DLL formata esse parâmetro com os endereços de função antes de retornar da chamada para a função Dot11ExtIhvInitService .

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 a função Dot11ExtIhvInitService imediatamente após a chamada para o Função Dot11ExtIhvGetVersionInfo . Quando chamado, Dot11ExtIhvInitService deve inicializar a DLL de Extensões IHV conforme necessário. Quando a função retorna, a DLL deve estar preparada para aceitar chamadas adicionais para a função manipulador IHV.

Ao contrário de como trata outras funções de Manipulador e Extensão IHV cujos endereços são resolvidos por meio do parâmetro pDot11IHVHandlers , o sistema operacional resolve o endereço da função Dot11ExtIhvInitService chamando a função GetProcAddress . Como resultado, o desenvolvedor da DLL de Extensões IHV deve seguir estas diretrizes.

  • A DLL deve implementar uma função chamada Dot11ExtIhvInitService, que tem o formato descrito neste tópico.
  • A instrução EXPORTS do arquivo de definição de módulo de origem (.def), que é usada para criar a DLL de Extensões IHV, deve conter uma entrada de nome de função para a função Dot11ExtIhvInitService .
Para obter mais informações sobre GetProcAddress, consulte a documentação do SDK do Microsoft Windows.

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

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo