DOT11EXTIHV_INIT_SERVICE 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 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 parâmetro função Dot11ExtIhvGetVersionInfo 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 do 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 de 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.

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 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 extensão e manipulador de 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 essas 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
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

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo

Compartilhar via