IChannelAudioVolume::GetChannelVolume method (audioclient.h)
Metode GetChannelVolume mengambil tingkat volume untuk saluran yang ditentukan dalam sesi audio.
Sintaks
HRESULT GetChannelVolume(
[in] UINT32 dwIndex,
[out] float *pfLevel
);
Parameter
[in] dwIndex
Nomor saluran. Jika format streaming untuk sesi audio memiliki saluran N , maka saluran diberi nomor dari 0 hingga N– 1. Untuk mendapatkan jumlah saluran, hubungi metode IChannelAudioVolume::GetChannelCount .
[out] pfLevel
Pointer ke variabel float tempat metode menulis tingkat volume saluran yang ditentukan. Tingkat volume berada dalam rentang 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 dwIndex diatur ke nomor saluran yang tidak valid. |
|
Parameter pfLevel adalah NULL. |
|
Perangkat titik akhir audio telah dicabut, atau perangkat keras audio atau sumber daya perangkat keras terkait telah dikonfigurasi ulang, dinonaktifkan, dihapus, atau tidak tersedia untuk digunakan. |
|
Layanan audio Windows tidak berjalan. |
Keterangan
Klien dapat memanggil metode IChannelAudioVolume::SetAllVolumes atau IChannelAudioVolume::SetChannelVolume untuk mengatur tingkat volume per saluran dalam sesi audio.
Persyaratan
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | audioclient.h |
Lihat juga
IChannelAudioVolume::GetChannelCount