Remoção do adaptador WLAN 802.11

 

Quando um adaptador WLAN (LAN sem fio) é removido ou desabilitado, o sistema operacional chama Dot11ExtIhvDeinitAdapter para notificar a DLL de Extensões IHV da remoção do adaptador. O sistema operacional também chama a função Dot11ExtIhvDeinitAdapter para cada adaptador gerenciado pela DLL de Extensões IHV antes que o sistema operacional descarregue a DLL.

Quando Dot11ExtIhvDeinitAdapter é chamado, a DLL de Extensões IHV deve seguir estas diretrizes.

• A DLL de Extensões IHV deve liberar todos os recursos alocados para o adaptador WLAN. Em particular, toda a memória alocada por meio de chamadas para Dot11ExtAllocateBuffer deve ser liberada por meio de chamadas para Dot11ExtFreeBuffer.

• O identificador usado pelo sistema operacional para referenciar o adaptador WLAN não é mais válido quando Dot11ExtIhvDeinitAdapter é chamado. O sistema operacional passa seu identificador para a DLL de Extensões IHV por meio do parâmetro hDot11SvcHandle quando Dot11ExtIhvInitAdapter é chamado.

  Dentro da chamada para a função Dot11ExtIhvDeinitAdapter e depois de retornar da chamada, a DLL não deve usar o valor do identificador ao chamar qualquer função de Extensibilidade IHV que declare um parâmetro hDot11SvcHandle , como Dot11ExtSendPacket.

• Se a DLL de Extensões IHV tiver uma operação de pré-associação pendente, que foi iniciada por meio de uma chamada para a função manipulador IHV Dot11ExtIhvPerformPreAssociate , o sistema operacional considerará a operação como cancelada por meio da chamada para a função Dot11ExtIhvDeinitAdapter . Dentro da chamada, a DLL deve cancelar a operação de pré-associação internamente, mas não deve chamar Dot11ExtPreAssociateCompletion para concluir a operação de pré-associação.

  Para obter mais informações sobre a operação de pré-associação, consulte Operações de pré-associação.

• Se a DLL de Extensões IHV tiver uma operação pós-associação pendente, que foi iniciada por meio de uma chamada para a função Manipulador IHV Dot11ExtIhvPerformPostAssociate , o sistema operacional cancelará a operação chamando a função Dot11ExtIhvStopPostAssociate antes de chamar Dot11ExtIhvDeinitAdapter.

  Para obter mais informações sobre a operação pós-associação, consulte Operações pós-associação.

• O sistema operacional chama a função Dot11ExtIhvDeinitAdapter para cada adaptador gerenciado pela DLL de Extensões IHV antes que o sistema operacional descarregue a DLL. Nessa situação, o sistema operacional chama a função Dot11ExtIhvDeinitService IHV Handler depois que o último adaptador WLAN foi interrompido por meio de uma chamada para Dot11ExtIhvDeinitAdapter.

  Para obter mais informações sobre essa operação, consulte Operações de parada de DLL.