Compartilhar via


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.