DOT11EXTIHV_INIT_VIRTUAL_STATION 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 Dot11ExtIhvInitVirtualStation para inicializar a DLL de Extensões IHV para operações de estação virtual e inicializar a interface de API entre o sistema operacional e a DLL.

Sintaxe

DOT11EXTIHV_INIT_VIRTUAL_STATION Dot11extihvInitVirtualStation;

DWORD Dot11extihvInitVirtualStation(
  [in] PDOT11EXT_VIRTUAL_STATION_APIS pDot11ExtVSAPI,
       LPVOID pvReserved
)
{...}

Parâmetros

[in] pDot11ExtVSAPI

Um ponteiro para um DOT11EXT_VIRTUAL_STATION_APIS estrutura, que contém os endereços das funções de estação virtual 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 uma chamada para a função Dot11ExtIhvInitVirtualStation .

pvReserved

Esse parâmetro é reservado para uso pelo sistema operacional e deve ser NULL.

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

É opcional que a DLL de Extensões IHV implemente e exporte essa função.

O sistema operacional chama a função Dot11ExtIhvInitVirtualStation imediatamente após chamar a função Dot11ExtIhvInitService , mas antes de chamar o Função Dot11ExtIhvInitAdapter .

Em resposta a uma chamada para Dot11ExtIhvInitVirtualStation, a DLL de Extensões IHV pode inicializar suas estruturas de dados internas com as informações fornecidas da chamada de função Dot11ExtIhvInitService .

Nota A DLL de Extensões IHV tem permissão para chamar as funções de API da estação virtual para as quais o parâmetro pDot11ExtVSAPI aponta somente após o retorno da função Dot11ExtIhvInitVirtualStation .
 
O sistema operacional resolve o endereço da função Dot11ExtIhvInitVirtualStation chamando a função GetProcAddress . Como resultado, o desenvolvedor da DLL de Extensões IHV deverá seguir estas diretrizes se essa função for implementada.
  • A DLL deve implementar uma função chamada Dot11ExtIhvInitVirtualStation, 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 compilar a DLL de Extensões IHV, deve conter uma entrada de nome de função para a função Dot11ExtIhvInitVirtualStation .
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 7 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