Metode IAudioEndpointVolume::GetChannelVolumeLevelScalar (endpointvolume.h)
Metode GetChannelVolumeLevelScalar mendapatkan tingkat volume audio-tapered yang dinormalisasi dari saluran tertentu dari aliran audio yang masuk atau meninggalkan perangkat titik akhir audio.
Sintaks
HRESULT GetChannelVolumeLevelScalar(
[in] UINT nChannel,
[out] float *pfLevel
);
Parameter
[in] nChannel
Nomor saluran. Jika aliran audio berisi saluran n , saluran dinomor dari 0 hingga n– 1. Untuk mendapatkan jumlah saluran, hubungi metode IAudioEndpointVolume::GetChannelCount .
[out] pfLevel
Penunjuk ke variabel float tempat metode menulis tingkat volume. Tingkat dinyatakan sebagai nilai yang dinormalisasi dalam rentang dari 0,0 hingga 1,0.
Mengembalikan 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 nChannel lebih besar dari atau sama dengan jumlah saluran dalam aliran. |
|
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 Audio-Tapered Volume Controls.
Tingkat volume yang dinormalisasi yang diambil oleh metode ini cocok untuk mewakili posisi kontrol volume di jendela aplikasi dan tampilan di layar.
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
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