Metode IAudioEndpointVolume::SetChannelVolumeLevel (endpointvolume.h)

Metode SetChannelVolumeLevel mengatur tingkat volume, dalam desibel, dari saluran aliran audio yang ditentukan yang memasuki atau meninggalkan perangkat titik akhir audio.

Sintaks

HRESULT SetChannelVolumeLevel(
  [in] UINT    nChannel,
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] nChannel

Nomor saluran. Jika aliran audio berisi saluran n , saluran diberi nomor dari 0 hingga n– 1. Untuk mendapatkan jumlah saluran, panggil metode IAudioEndpointVolume::GetChannelCount .

[in] fLevelDB

Tingkat volume 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 SetChannelVolumeLevel 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 disertakan, 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 fLevelDB terletak di luar rentang volume yang didukung oleh perangkat.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Jika tingkat volume fLevelDB berada di luar rentang volume yang dilaporkan oleh metode IAudioEndpointVolume::GetVolumeRange , panggilan SetChannelVolumeLevel gagal dan mengembalikan kode kesalahan E_INVALIDARG.

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

IAudioEndpointVolume::GetVolumeRange

Antarmuka IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify