Metode IAudioEndpointVolume::SetMasterVolumeLevelScalar (endpointvolume.h)
Metode SetMasterVolumeLevelScalar mengatur tingkat volume master aliran audio yang memasuki atau meninggalkan perangkat titik akhir audio. Tingkat volume dinyatakan sebagai nilai yang dinormalisasi dan di-taper audio dalam rentang dari 0,0 hingga 1,0.
Sintaks
HRESULT SetMasterVolumeLevelScalar(
[in] float fLevel,
[in] LPCGUID pguidEventContext
);
Parameter
[in] fLevel
Tingkat volume master baru. Tingkat dinyatakan sebagai nilai yang dinormalisasi dalam rentang dari 0,0 hingga 1,0.
[in] pguidEventContext
Nilai konteks untuk metode IAudioEndpointVolumeCallback::OnNotify . Parameter ini menunjuk ke GUID konteks peristiwa. Jika panggilan SetMasterVolumeLevelScalar 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 disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Parameter fLevel berada di luar rentang dari 0,0 hingga 1,0. |
|
Kehabisan memori. |
Keterangan
Tingkat volume dinormalisasi ke kisaran dari 0,0 hingga 1,0, di mana 0,0 adalah tingkat volume minimum dan 1,0 adalah tingkat maksimum. Dalam rentang ini, hubungan tingkat volume yang dinormalisasi dengan redaman amplitude sinyal dijelaskan oleh kurva nonlinear dan audio-tapered. Perhatikan bahwa bentuk kurva mungkin berubah dalam versi Windows yang akan datang. Untuk informasi selengkapnya tentang kurva audio-tapered, lihat Kontrol Volume Audio-Tapered.
Tingkat volume yang dinormalisasi yang diteruskan ke metode ini cocok untuk mewakili posisi kontrol volume di jendela aplikasi dan tampilan di layar.
Untuk contoh kode yang memanggil SetMasterVolumeLevelScalar, lihat Kontrol Volume Titik Akhir.
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
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