Metode IAudioEndpointVolume::SetMasterVolumeLevel (endpointvolume.h)
Metode SetMasterVolumeLevel mengatur tingkat volume master, dalam desibel, dari aliran audio yang masuk atau meninggalkan perangkat titik akhir audio.
Sintaks
HRESULT SetMasterVolumeLevel(
[in] float fLevelDB,
[in] LPCGUID pguidEventContext
);
Parameter
[in] fLevelDB
Tingkat volume master baru dalam desibel. Untuk mendapatkan rentang dan granularitas tingkat volume yang dapat diatur oleh metode ini, panggil metode IAudioEndpointVolume::GetVolumeRange .
[in] pguidEventContext
Nilai konteks untuk metode IAudioEndpointVolumeCallback::OnNotify . Parameter ini menunjuk ke GUID konteks peristiwa. Jika panggilan SetMasterVolumeLevel mengubah tingkat volume titik akhir, semua klien yang telah mendaftarkan antarmuka IAudioEndpointVolumeCallback dengan titik akhir tersebut akan menerima pemberitahuan. Dalam implementasi metode OnNotify , klien dapat memeriksa GUID konteks peristiwa untuk menemukan apakah itu atau klien lain adalah sumber peristiwa perubahan volume. Jika penelepon menyediakan pointer NULL untuk parameter ini, rutinitas pemberitahuan menerima nilai GUID konteks GUID_NULL.
Menampilkan nilai
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Parameter fLevelDB berada di luar rentang volume yang didukung oleh perangkat. |
|
Kehabisan memori. |
Keterangan
Jika tingkat volume fLevelDB berada di luar rentang volume yang dilaporkan oleh metode IAudioEndpointVolume::GetVolumeRange , panggilan SetMasterVolumeLevel gagal dan mengembalikan kode kesalahan E_INVALIDARG.
Persyaratan
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 | endpointvolume.h |
Lihat juga
Antarmuka IAudioEndpointVolume
IAudioEndpointVolume::GetVolumeRange
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk