Compartilhar via


Funções de extensibilidade de IHV nativas 802.11

Importante

A interface lan sem fio Nativa 802.11 foi 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.

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 Nativa 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 do 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 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 de 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 Dot11ExtIhvInitService IHV Handler tiver sido 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 IHV só pode ser chamada depois que a função Dot11ExtIhvInitAdapter IHV Handler tiver sido chamada para inicializar a interface para o adaptador WLAN do IHV.
    A função de extensibilidade IHV requer um handle, que identifica o adaptador WLAN. Quando Dot11ExtIhvInitAdapter é chamado, esse identificador é passado para a DLL de Extensões IHV 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 pré-associação
    A função extensibilidade IHV só pode ser chamada depois que a função Dot11ExtIhvPerformPreAssociate IHV Handler tiver sido chamada para iniciar uma operação de pré-associação com uma rede BSS (conjunto de serviços básico).
    A função de extensibilidade IHV requer um handle, que identifica a conexão de rede BSS. Quando Dot11ExtIhvPerformPreAssociate é chamado, a DLL de Extensões IHV recebe 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 tiverem sido chamadas.
  • Chamado após a Pós-Associação
    A função de extensibilidade IHV apenas pode ser chamada depois que a função Dot11ExtIhvPerformPostAssociate do IHV Handler tiver sido chamada para iniciar uma operação pós-associação com uma rede BSS (conjunto de serviços básico).
    A função extensibilidade de IHV requer um identificador, que identifica a sessão de segurança com a conexão de rede BSS. Quando Dot11ExtIhvPerformPostAssociate é chamado, o identificador da DLL de Extensões IHV é passado 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 tiverem sido 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 pós-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 as funções do manipulador de IHV nativo 802.11, consulte Funções do Manipulador de IHV Nativo 802.11.