Metode IAudioEndpointVolume::SetChannelVolumeLevelScalar (endpointvolume.h)

Artikel
02/26/2024

Metode SetChannelVolumeLevelScalar mengatur tingkat volume audio-tapered yang dinormalisasi dari saluran yang ditentukan dalam aliran audio yang memasuki atau meninggalkan perangkat titik akhir audio.

Sintaks

HRESULT SetChannelVolumeLevelScalar(
  [in] UINT    nChannel,
  [in] float   fLevel,
  [in] LPCGUID pguidEventContext
);

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 .

[in] fLevel

Tingkat volume. Tingkat volume 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 SetChannelVolumeLevelScalar 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.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter nChannel lebih besar dari atau sama dengan jumlah saluran dalam aliran; atau parameter fLevel berada di luar rentang dari 0,0 hingga 1,0.
E_OUTOFMEMORY	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 Audio-Tapered Volume Controls.

Tingkat volume yang dinormalisasi yang diteruskan ke metode ini cocok untuk mewakili posisi kontrol volume di jendela aplikasi dan tampilan di layar.

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

Lihat juga

Antarmuka IAudioEndpointVolume

IAudioEndpointVolume::GetChannelCount

Antarmuka IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify

Bagikan melalui