DOT11EXTIHV_INIT_VIRTUAL_STATION função de retorno de chamada (wlanihv.h)

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 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 com suporte do 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.

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

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

O sistema operacional chama a função do 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.

Observação 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 para 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 essas 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 criar 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
de cliente com suporte mínimo	Disponível no Windows 7 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