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.