Metode IAudioEndpointVolume::GetMasterVolumeLevelScalar (endpointvolume.h)
Metode GetMasterVolumeLevelScalar mendapatkan tingkat volume master aliran audio yang masuk 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 GetMasterVolumeLevelScalar(
[out] float *pfLevel
);
Parameter
[out] pfLevel
Arahkan ke tingkat volume master. Parameter ini menunjuk ke variabel float tempat metode menulis tingkat volume. Tingkat dinyatakan sebagai nilai yang dinormalisasi dalam rentang dari 0,0 hingga 1,0.
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 |
---|---|
|
Parameter pfLevel adalah NULL. |
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 diambil oleh metode ini cocok untuk mewakili posisi kontrol volume di jendela aplikasi dan tampilan di layar.
Untuk contoh kode yang memanggil GetMasterVolumeLevelScalar, lihat Kontrol Volume Titik Akhir.
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 | endpointvolume.h |