Funções de extensibilidade de IHV nativas 802.11

Importante

A interface lan sem fio Nativa 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.

As funções de Extensibilidade IHV nativas 802.11 são fornecidas pelo sistema operacional e são chamadas pela DLL de Extensões IHV para fazer o seguinte:

• Alocar e liberar buffers que são usados na estrutura Native 802.11.
• Envie pacotes, como um pacote definido por um algoritmo de autenticação, por meio do adaptador WLAN (LAN sem fio) do IHV.
• Configure o adaptador WLAN do IHV com várias configurações de segurança para quaisquer algoritmos de autenticação e codificação compatíveis com a DLL de Extensões IHV.
• Interface com a DLL de Extensões de Interface do Usuário IHV (se instalada) para processar notificações de evento. Por exemplo, a DLL de Extensões IHV pode notificar a DLL de Extensões de Interface do Usuário IHV sobre os vários estágios envolvidos em uma conexão de rede BSS (conjunto de serviços básico).

Para obter mais informações sobre a DLL de extensões de interface do usuário IHV, consulte DLL de extensões de interface do usuário de IHV nativas 802.11.

Observação

A DLL de Extensões IHV chama cada função de Extensibilidade IHV Nativa 802.11 por meio de um ponteiro de função associado a um membro da estrutura de DOT11EXT_APIS . Quando o sistema operacional chama a função Manipulador IHV Dot11ExtIhvInitService , ele passa a lista de ponteiros para as funções de Extensibilidade IHV por meio do parâmetro pDot11ExtAPI .

A tabela a seguir lista as funções de extensibilidade IHV nativas 802.11 que podem ser chamadas pela DLL de Extensões IHV. Cada função de Extensibilidade IHV só pode ser chamada nessas condições.

• Chamado após a inicialização do serviço
  A função Extensibilidade de IHV só pode ser chamada depois que a função Manipulador IHV Dot11ExtIhvInitService foi chamada para inicializar a DLL de Extensões IHV. Além disso, a DLL de Extensões não pode chamar a função extensibilidade IHV depois que a função Dot11ExtIhvDeinitService IHV Handler tiver sido chamada.
• Chamado após a inicialização do adaptador
  A função Extensibilidade de IHV só pode ser chamada depois que a função Manipulador de IHV Dot11ExtIhvInitAdapter foi chamada para inicializar a interface para o adaptador WLAN do IHV.
  A função extensibilidade IHV requer um identificador, que identifica o adaptador WLAN. Quando Dot11ExtIhvInitAdapter é chamado, a DLL de Extensões IHV é passada por esse identificador por meio do parâmetro hDot11SvcHandle .
  A DLL de Extensões não pode chamar a função extensibilidade IHV depois que a função Dot11ExtIhvDeinitAdapter IHV Handler tiver sido chamada.
• Chamado após a pré-associação
  A função extensibilidade IHV só pode ser chamada depois que a função Dot11ExtIhvPerformPreAssociate IHV Handler foi chamada para iniciar uma operação de pré-associação com uma rede BSS (conjunto de serviços) básica.
  A função extensibilidade IHV requer um identificador, que identifica a conexão de rede BSS. Quando Dot11ExtIhvPerformPreAssociate é chamado, a DLL de Extensões IHV é passada por esse identificador por meio do parâmetro hConnection .
  A DLL de Extensões não pode chamar a função extensibilidade IHV depois que as funções Dot11ExtIhvDeinitAdapter ou Dot11ExtIhvAdapterReset IHV Handler forem chamadas.
• Chamado após a Pós-Associação
  A função extensibilidade IHV só pode ser chamada depois que a função do Manipulador de IHV Dot11ExtIhvPerformPostAssociate foi chamada para iniciar uma operação pós-associação com uma rede BSS (conjunto de serviços) básica.
  A função extensibilidade IHV requer um identificador, que identifica a sessão de segurança com a conexão de rede BSS. Quando Dot11ExtIhvPerformPostAssociate é chamado, a DLL de Extensões IHV é passada por esse identificador por meio do parâmetro hSecuritySessionID .
  A DLL de Extensões não pode chamar a função extensibilidade IHV depois que as funções Dot11ExtIhvDeinitAdapter ou Dot11ExtIhvAdapterReset IHV Handler forem chamadas.

Função	Chamado após a inicialização do serviço	Chamado após a inicialização do adaptador	Chamado após a pré-associação	Chamado após a associação
Dot11ExtAllocateBuffer	X
Dot11ExtFreeBuffer	X
Dot11ExtGetProfileCustomUserData			X
Dot11ExtNicSpecificExtension		X
Dot11ExtStartOneX				X
Dot11ExtStopOneX				X
Dot11ExtPostAssociateCompletion				X
Dot11ExtPreAssociateCompletion			X
Dot11ExtProcessOneXPacket				X
Dot11ExtQueryVirtualStationProperties		X
Dot11ExtReleaseVirtualStation		X
Dot11ExtRequestVirtualStation		X
Dot11ExtSendNotification		X
Dot11ExtSendUIRequest		X
Dot11ExtSetAuthAlgorithm		X
Dot11ExtSetCurrentProfile			X
Dot11ExtSetDefaultKey		X
Dot11ExtSetDefaultKeyId		X
Dot11ExtSetEtherTypeHandling		X
Dot11ExtSetExcludeUnencrypted		X
Dot11ExtSetKeyMappingKey		X
Dot11ExtSetMulticastCipherAlgorithm		X
Dot11ExtSetProfileCustomUserData		X
Dot11ExtSetUnicastCipherAlgorithm		X
Dot11ExtSetVirtualStationAPProperties			X

Para obter mais informações sobre funções de manipulador IHV, consulte Funções de manipulador IHV nativas 802.11.