Metode IAudioSessionControl::GetDisplayName (audiopolicy.h)

Metode GetDisplayName mengambil nama tampilan untuk sesi audio.

Sintaks

HRESULT GetDisplayName(
  [out] LPWSTR *pRetVal
);

Parameter

[out] pRetVal

Penunjuk ke variabel penunjuk tempat metode menulis alamat string karakter lebar yang dihentikan null yang berisi nama tampilan. Metode mengalokasikan penyimpanan untuk string. Pemanggil bertanggung jawab untuk membebaskan penyimpanan, ketika tidak lagi diperlukan, dengan memanggil fungsi CoTaskMemFree . Untuk informasi tentang CoTaskMemFree, lihat dokumentasi Windows SDK.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_POINTER	Parameter pRetVal adalah NULL.
E_OUTOFMEMORY	Kehabisan memori.
AUDCLNT_E_DEVICE_INVALIDATED	Perangkat titik akhir audio telah dicabut, atau perangkat keras audio atau sumber daya perangkat keras terkait telah dikonfigurasi ulang, dinonaktifkan, dihapus, atau tidak tersedia untuk digunakan.
AUDCLNT_E_SERVICE_NOT_RUNNING	Layanan audio Windows tidak berjalan.

Keterangan

Jika klien belum memanggil IAudioSessionControl::SetDisplayName untuk mengatur nama tampilan, string akan kosong. Daripada menampilkan string nama kosong, program Sndvol menggunakan nama default yang dibuat secara otomatis untuk memberi label kontrol volume untuk 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

Antarmuka IAudioSessionControl

IAudioSessionControl::SetDisplayName