DOT11EXTIHV_INIT_ADAPTER 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 Dot11ExtIhvInitAdapter para que a DLL de Extensões IHV aloque e inicialize um contexto de adaptador.

Sintaxe

DOT11EXTIHV_INIT_ADAPTER Dot11extihvInitAdapter;

DWORD Dot11extihvInitAdapter(
  [in]           PDOT11_ADAPTER pDot11Adapter,
  [in, optional] HANDLE hDot11SvcHandle,
  [out]          PHANDLE phIhvExtAdapter
)
{...}

Parâmetros

[in] pDot11Adapter

Um ponteiro para uma estrutura DOT11_ADAPTER, que identifica o adaptador a ser inicializado.

[in, optional] hDot11SvcHandle

Um identificador atribuído pelo sistema operacional para o adaptador. A DLL de Extensões IHV deve usar esse valor de identificador ao chamar qualquer função de extensibilidade IHV que declare um parâmetro hDot11SvcHandle, como Dot11ExtPreAssociateCompletion.

[out] phIhvExtAdapter

Um ponteiro para uma variável de identificador. A DLL de Extensões IHV deve atribuir um valor de identificador exclusivo para o adaptador e definir * phIhvExtAdapter ao valor do identificador. O sistema operacional usa esse valor de identificador quando chama qualquer função do Manipulador IHV que declare um parâmetro hIhvExtAdapter, como Dot11ExtIhvPerformPreAssociate .

Normalmente, a DLL de Extensões IHV aloca uma matriz de estado para o contexto do adaptador e retorna o endereço da matriz como o valor do identificador.

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 Dot11ExtIhvInitAdapter sempre que um adaptador WLAN estiver disponível e habilitado para uso, como quando um adaptador PCMCIA é inserido.

Para obter mais informações sobre a inicialização do adaptador WLAN, consulte 802.11 WLAN Adapter Arrival.

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

funções de extensibilidade IHV nativas 802.11

Dot11ExtPreAssociateCompletion Dot11ExtIhvPerformPreAssociate

DOT11_ADAPTER

Partilhar via