DOT11EXTIHV_INIT_ADAPTER 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 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 como o valor do identificador. O sistema operacional usa esse valor de identificador quando chama qualquer função de 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.

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

O sistema operacional chama a função Dot11ExtIhvInitAdapter sempre que um adaptador WLAN fica 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 Chegada do adaptador WLAN 802.11.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wlanihv.h (inclua Wlanihv.h)

Confira também

Funções de extensibilidade IHV nativas 802.11

Dot11ExtPreAssociateCompletion Dot11ExtIhvPerformPreAssociate

DOT11_ADAPTER