MÉTHODE IMMNotificationClient ::OnPropertyValueChanged (mmdeviceapi.h)
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 |