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

A DLL de Extensões IHV chama a função Dot11ExtRequestVirtualStation para solicitar que o sistema operacional crie uma estação virtual 802.11.

Sintaxe

DOT11EXT_REQUEST_VIRTUAL_STATION Dot11extRequestVirtualStation;

DWORD Dot11extRequestVirtualStation(
  [in, optional] HANDLE hDot11PrimaryHandle,
                 LPVOID pvReserved
)
{...}

Parâmetros

[in, optional] hDot11PrimaryHandle

Um identificador usado pelo sistema operacional para referenciar o adaptador principal de LAN sem fio físico (WLAN). Esse valor de identificador foi recebido como o parâmetro hDot11SvcHandle por meio de uma chamada anterior para a função Dot11ExtIhvInitAdapter manipulador IHV.

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

Quando essa função de solicitação for concluída com êxito, o sistema operacional começará a processar a solicitação para criar uma estação virtual. É possível que o sistema operacional chame a função Dot11ExtIhvInitAdapter manipulador de IHV para inicializar a estação virtual antes ou depois da chamada para Dot11ExtRequestVirtualStation retorna.

Depois que o sistema operacional criar a nova estação virtual, a DLL de Extensões IHV deverá esperar receber uma chamada para a função do Manipulador de IHV Dot11ExtIhvInitAdapter. Nesta chamada, o sistema operacional passa um identificador para o novo adaptador virtual por meio do parâmetro hDot11SvcHandle.

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

Dot11ExtReleaseVirtualStation

Dot11ExtIhvInitAdapter

Compartilhar via