Interface IControlChangeNotify (devicetopology.h)
L’interface IControlChangeNotify fournit des notifications lorsque l’status d’une partie (connecteur ou sous-unité) change. Contrairement aux autres interfaces de cette section, qui sont implémentées par l’API DeviceTopology, l’interface IControlChangeNotify doit être implémentée par un client. Pour recevoir des notifications, le client passe un pointeur vers son interface IControlChangeNotify instance en tant que paramètre vers la méthode IPart::RegisterControlChangeCallback.
Après avoir inscrit son interface IControlChangeNotify , le client reçoit des notifications d’événements sous forme de rappels via la méthode OnNotify dans l’interface.
Lors de l’implémentation de l’interface IControlChangeNotify , le client doit respecter ces règles pour éviter les blocages et les comportements non définis :
- Les méthodes de l’interface doivent être non bloquantes. Le client ne doit jamais attendre un objet de synchronisation pendant un rappel d’événement.
- Le client ne doit jamais appeler la méthode IPart::UnregisterControlChangeCallback pendant un rappel d’événement.
- Le client ne doit jamais publier la référence finale sur un objet API MMDevice lors d’un rappel d’événement.
Héritage
L’interface IControlChangeNotify hérite de l’interface IUnknown. IControlChangeNotify a également les types de membres suivants :
Méthodes
L’interface IControlChangeNotify comporte ces méthodes.
| IControlChangeNotify::OnNotify La méthode OnNotify avertit le client lorsque le status d’un connecteur ou d’une sous-unité change. |
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | devicetopology.h |