Metode IAudioEndpointVolume::GetChannelVolumeLevel (endpointvolume.h)

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

Sintaks

HRESULT GetChannelVolumeLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevelDB
);

Parameter

[in] nChannel

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

[out] pfLevelDB

Penunjuk ke variabel float tempat metode menulis tingkat volume dalam desibel. Untuk mendapatkan rentang tingkat volume yang diperoleh dari metode ini, panggil metode IAudioEndpointVolume::GetVolumeRange .

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
E_INVALIDARG	Parameter nChannel lebih besar dari atau sama dengan jumlah saluran dalam aliran.
E_POINTER	Parameter pfLevelDB adalah NULL.

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

IAudioEndpointVolume::GetChannelCount

IAudioEndpointVolume::GetVolumeRange