IChannelAudioVolume::GetChannelVolume method (audioclient.h)

Artikel
08/22/2023

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
E_INVALIDARG	Parameter dwIndex diatur ke nomor saluran yang tidak valid.
E_POINTER	Parameter pfLevel adalah NULL.
AUDCLNT_E_DEVICE_INVALIDATED	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.
AUDCLNT_E_SERVICE_NOT_RUNNING	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

Antarmuka IChannelAudioVolume

IChannelAudioVolume::GetChannelCount

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume

Share via