Metode IChannelAudioVolume::GetAllVolumes (audioclient.h)

Artikel
08/22/2023

Metode GetAllVolumes mengambil tingkat volume untuk semua saluran dalam sesi audio.

Sintaks

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

Parameter

[in] dwCount

Jumlah elemen dalam array pfVolumes . Parameter dwCount harus sama dengan jumlah saluran dalam format aliran untuk sesi audio. Untuk mendapatkan jumlah saluran, hubungi metode IChannelAudioVolume::GetChannelCount .

[out] pfVolumes

Arahkan ke array tingkat volume untuk saluran dalam sesi audio. Parameter ini menunjuk ke array float yang dialokasikan pemanggil tempat metode menulis tingkat volume untuk saluran individual. Tingkat volume berada dalam rentang 0,0 hingga 1,0.

Menampilkan nilai

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 dwCount tidak sama dengan jumlah saluran dalam format aliran untuk sesi audio.
E_POINTER	Parameter pfVolumes 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