Interface IMMNotificationClient (mmdeviceapi.h)

L’interface IMMNotificationClient fournit des notifications lorsqu’un appareil de point de terminaison audio est ajouté ou supprimé, lorsque l’état ou les propriétés d’un appareil de point de terminaison changent, ou lorsqu’une modification est apportée au rôle par défaut attribué à un appareil de point de terminaison. Contrairement aux autres interfaces de cette section, qui sont implémentées par le composant système de l’API MMDevice, un client d’API MMDevice implémente l’interface IMMNotificationClient . Pour recevoir des notifications, le client passe un pointeur vers son interface IMMNotificationClient instance en tant que paramètre vers la méthode IMMDeviceEnumerator::RegisterEndpointNotificationCallback.

Après avoir inscrit son interface IMMNotificationClient , le client reçoit des notifications d’événements sous forme de rappels via les méthodes de l’interface.

Chaque méthode de l’interface IMMNotificationClient reçoit, comme l’un de ses paramètres d’entrée, une chaîne d’ID de point de terminaison qui identifie le périphérique de point de terminaison audio faisant l’objet de la notification. La chaîne identifie de manière unique l’appareil par rapport à tous les autres appareils de point de terminaison audio du système. Les méthodes de l’implémentation de l’interface IMMNotificationClient doivent traiter cette chaîne comme opaque. Autrement dit, aucune des méthodes ne doit tenter d’analyser le contenu de la chaîne pour obtenir des informations sur l’appareil. La raison en est que le format de chaîne n’est pas défini et peut changer d’une implémentation du module système d’API MMDevice à la suivante.

Un client peut utiliser la chaîne d’ID de point de terminaison qu’il reçoit comme paramètre d’entrée dans un appel à une méthode IMMNotificationClient de deux manières :

• Le client peut créer une instance de l’appareil que la chaîne d’ID de point de terminaison identifie. Pour ce faire, le client appelle la méthode IMMDeviceEnumerator::GetDevice et fournit la chaîne d’ID de point de terminaison en tant que paramètre d’entrée.
• Le client peut comparer la chaîne d’ID de point de terminaison à la chaîne d’ID de point de terminaison d’un appareil existant instance. Pour obtenir la deuxième chaîne d’ID de point de terminaison, le client appelle la méthode IMMDevice::GetId de l’appareil instance. Si les deux chaînes correspondent, elles identifient le même appareil.

Lors de l’implémentation de l’interface IMMNotificationClient , le client doit observer ces règles pour éviter les interblocages et les comportements non définis :

• Les méthodes de l’interface doivent être non bloquantes. Le client ne doit jamais attendre sur un objet de synchronisation pendant un rappel d’événement.
• Pour éviter les verrous morts, le client ne doit jamais appeler IMMDeviceEnumerator::RegisterEndpointNotificationCallback ou IMMDeviceEnumerator::UnregisterEndpointNotificationCallback dans son implémentation des méthodes IMMNotificationClient .
• Le client ne doit jamais publier la référence finale sur un objet API MMDevice pendant un rappel d’événement.

Pour obtenir un exemple de code qui implémente l’interface IMMNotificationClient , consultez Événements d’appareil.

Héritage

L’interface IMMNotificationClient hérite de l’interface IUnknown . IMMNotificationClient a également les types de membres suivants :

Méthodes

L’interface IMMNotificationClient a ces méthodes.

IMMNotificationClient::OnDefaultDeviceChanged La méthode OnDefaultDeviceChanged avertit le client que le périphérique de point de terminaison audio par défaut pour un rôle d’appareil particulier a changé.
IMMNotificationClient::OnDeviceAdded La méthode OnDeviceAdded indique qu’un nouveau périphérique de point de terminaison audio a été ajouté.
IMMNotificationClient::OnDeviceRemoved La méthode OnDeviceRemoved indique qu’un périphérique de point de terminaison audio a été supprimé.
IMMNotificationClient::OnDeviceStateChanged La méthode OnDeviceStateChanged indique que l’état d’un appareil de point de terminaison audio a changé.
IMMNotificationClient::OnPropertyValueChanged La méthode OnPropertyValueChanged indique que la valeur d’une propriété appartenant à un appareil de point de terminaison audio a changé.

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	mmdeviceapi.h

Voir aussi

Interfaces audio principales

IMMDevice::GetId

IMMDeviceEnumerator::GetDevice

IMMDeviceEnumerator::RegisterEndpointNotificationCallback

IMMDeviceEnumerator::UnregisterEndpointNotificationCallback

MMDevice API