Partager via

MÉTHODE IMMNotificationClient ::OnPropertyValueChanged (mmdeviceapi.h)

  • Article

La méthode OnPropertyValueChanged indique que la valeur d’une propriété appartenant à un appareil de point de terminaison audio a changé.

Syntaxe

HRESULT OnPropertyValueChanged(
  [in] LPCWSTR           pwstrDeviceId,
  [in] const PROPERTYKEY key
);

Paramètres

[in] pwstrDeviceId

Pointeur vers la chaîne d’ID de point de terminaison qui identifie le périphérique de point de terminaison audio. Ce paramètre pointe vers une chaîne de caractères larges terminée par null qui contient l’ID de point de terminaison. La chaîne reste valide pendant la durée de l’appel.

[in] key

Structure PROPERTYKEY qui spécifie la propriété. La structure contient le GUID de jeu de propriétés et un index identifiant une propriété dans le jeu. La structure est transmise par valeur. Il reste valide pendant la durée de l’appel. Pour plus d’informations sur PROPERTYKEY, consultez la documentation SDK Windows.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.

Remarques

Un appel à la méthode IPropertyStore ::SetValue qui modifie correctement la valeur d’une propriété d’un appareil de point de terminaison audio génère un appel à OnPropertyValueChanged. Pour plus d’informations sur IPropertyStore ::SetValue, consultez la documentation SDK Windows.

Un client peut utiliser le paramètre key pour récupérer la nouvelle valeur de propriété. Pour obtenir un exemple de code qui utilise une clé de propriété pour récupérer une valeur de propriété à partir du magasin de propriétés d’un appareil de point de terminaison, consultez Propriétés de l’appareil.

Pour obtenir un exemple de code qui implémente la méthode OnPropertyValueChanged , consultez Événements d’appareil.

Configuration requise

Condition requise Valeur
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

IMMNotificationClient Interface