Metode IMMNotificationClient::OnPropertyValueChanged (mmdeviceapi.h)

Metode OnPropertyValueChanged menunjukkan bahwa nilai properti milik perangkat titik akhir audio telah berubah.

Sintaks

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

Parameter

[in] pwstrDeviceId

Penunjuk ke string ID titik akhir yang mengidentifikasi perangkat titik akhir audio. Parameter ini menunjuk ke string karakter lebar yang dihentikan null yang berisi ID titik akhir. String tetap valid selama durasi panggilan.

[in] key

Struktur PROPERTYKEY yang menentukan properti . Struktur berisi GUID set properti dan indeks yang mengidentifikasi properti dalam set. Struktur diteruskan oleh nilai. Ini tetap berlaku selama durasi panggilan. Untuk informasi selengkapnya tentang PROPERTYKEY, lihat dokumentasi Windows SDK.

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kode kesalahan akan dikembalikan.

Keterangan

Panggilan ke metode IPropertyStore::SetValue yang berhasil mengubah nilai properti perangkat titik akhir audio menghasilkan panggilan ke OnPropertyValueChanged. Untuk informasi selengkapnya tentang IPropertyStore::SetValue, lihat dokumentasi Windows SDK.

Klien dapat menggunakan parameter kunci untuk mengambil nilai properti baru. Untuk contoh kode yang menggunakan kunci properti untuk mengambil nilai properti dari penyimpanan properti perangkat titik akhir, lihat Properti Perangkat.

Untuk contoh kode yang mengimplementasikan metode OnPropertyValueChanged , lihat Peristiwa Perangkat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mmdeviceapi.h

Lihat juga

Antarmuka IMMNotificationClient