802.11 Suppression de l’adaptateur WLAN

 

Lorsqu’un adaptateur LAN sans fil (WLAN) est supprimé ou désactivé, le système d’exploitation appelle Dot11ExtIhvDeinitAdapter pour informer la DLL d’extensions IHV de la suppression de l’adaptateur. Le système d’exploitation appelle également la fonction Dot11ExtIhvDeinitAdapter pour chaque adaptateur géré par la DLL des extensions IHV avant que le système d’exploitation décharge la DLL.

Lorsque Dot11ExtIhvDeinitAdapter est appelé, la DLL des extensions IHV doit suivre ces instructions.

• La DLL des extensions IHV doit libérer toutes les ressources allouées pour l’adaptateur WLAN. En particulier, toute la mémoire allouée via les appels à Dot11ExtAllocateBuffer doit être libérée par les appels à Dot11ExtFreeBuffer.

• Le handle utilisé par le système d’exploitation pour référencer l’adaptateur WLAN n’est plus valide lorsque Dot11ExtIhvDeinitAdapter est appelé. Le système d’exploitation transmet son handle à la DLL des extensions IHV via le paramètre hDot11SvcHandle lorsque Dot11ExtIhvInitAdapter est appelé.

  Dans l’appel à la fonction Dot11ExtIhvDeinitAdapter et après le retour de l’appel, la DLL ne doit pas utiliser la valeur de handle lors de l’appel d’une fonction d’extensibilité IHV qui déclare un paramètre hDot11SvcHandle , tel que Dot11ExtSendPacket.

• Si la DLL des extensions IHV avait une opération de pré-association en attente, qui a été lancée par le biais d’un appel à la fonction gestionnaire IHV Dot11ExtIhvPerformPreAssociate , le système d’exploitation considère l’opération comme annulée via l’appel à la fonction Dot11ExtIhvDeinitAdapter . Dans l’appel, la DLL doit annuler l’opération de pré-association en interne, mais ne doit pas appeler Dot11ExtPreAssociateCompletion pour terminer l’opération de pré-association.

  Pour plus d’informations sur l’opération de pré-association, consultez Opérations de pré-association.

• Si la DLL des extensions IHV avait une opération post-association en attente, qui a été lancée par le biais d’un appel à la fonction de gestionnaire IHV Dot11ExtIhvPerformPostAssociate , le système d’exploitation annule l’opération en appelant la fonction Dot11ExtIhvStopPostAssociate avant d’appeler Dot11ExtIhvDeinitAdapter.

  Pour plus d’informations sur l’opération post-association, consultez Opérations post-association.

• Le système d’exploitation appelle la fonction Dot11ExtIhvDeinitAdapter pour chaque adaptateur géré par la DLL des extensions IHV avant que le système d’exploitation décharge la DLL. Dans ce cas, le système d’exploitation appelle la fonction de gestionnaire Dot11ExtIhvDeinitService IHV après l’arrêt du dernier adaptateur WLAN via un appel à Dot11ExtIhvDeinitAdapter.

  Pour plus d’informations sur cette opération, consultez Opérations d’arrêt de DLL.