Metode IAudioSessionEvents::OnDisplayNameChanged (audiopolicy.h)

Metode OnDisplayNameChanged memberi tahu klien bahwa nama tampilan untuk sesi telah berubah.

Sintaks

HRESULT OnDisplayNameChanged(
  [in] LPCWSTR NewDisplayName,
  [in] LPCGUID EventContext
);

Parameter

[in] NewDisplayName

Nama tampilan baru untuk sesi tersebut. Parameter ini menunjuk ke string karakter lebar yang dihentikan null yang berisi nama tampilan baru. String tetap valid selama durasi panggilan.

[in] EventContext

Nilai konteks peristiwa. Ini adalah nilai yang sama dengan pemanggil yang diteruskan ke IAudioSessionControl::SetDisplayName dalam panggilan yang mengubah nama tampilan untuk sesi. Untuk informasi selengkapnya, lihat Keterangan.

Menampilkan nilai

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

Keterangan

Manajer sesi memanggil metode ini setiap kali panggilan ke metode IAudioSessionControl::SetDisplayName mengubah nama tampilan sesi. Program Sndvol menggunakan nama tampilan sesi untuk memberi label slider volume untuk sesi tersebut.

Parameter EventContext menyediakan sarana bagi klien untuk membedakan antara perubahan nama tampilan yang dimulai dan yang dimulai oleh beberapa klien lain. Saat memanggil metode IAudioSessionControl::SetDisplayName , klien meneruskan nilai parameter EventContext yang dapat dikenali implementasi metode OnDisplayNameChanged-nya .

Untuk contoh kode yang mengimplementasikan metode di antarmuka IAudioSessionEvents , lihat Peristiwa Sesi Audio.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	audiopolicy.h

Lihat juga

IAudioSessionControl::SetDisplayName

Antarmuka IAudioSessionEvents