Metode IAudioStreamVolume::SetAllVolumes (audioclient.h)

Metode SetAllVolumes mengatur tingkat volume individual untuk semua saluran dalam aliran audio.

Sintaks

HRESULT SetAllVolumes(
  [in] UINT32      dwCount,
  [in] const float *pfVolumes
);

Parameter

[in] dwCount

Jumlah elemen dalam array pfVolumes . Parameter ini harus sama dengan jumlah saluran dalam format aliran. Untuk mendapatkan jumlah saluran, panggil metode IAudioStreamVolume::GetChannelCount .

[in] pfVolumes

Arahkan ke array tingkat volume untuk saluran di aliran audio. Jumlah elemen dalam array pfVolumes ditentukan oleh parameter dwCount . Pemanggil menulis tingkat volume untuk setiap saluran ke elemen array yang indeksnya cocok dengan nomor saluran. Jika format aliran memiliki saluran N , saluran diberi nomor dari 0 hingga N– 1. Tingkat volume yang valid 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 dwCount tidak sama dengan jumlah saluran dalam aliran, atau nilai elemen array pfVolumes tidak berada dalam rentang 0,0 hingga 1,0.
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.

Persyaratan

Persyaratan	Nilai
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 IAudioStreamVolume

IAudioStreamVolume::GetChannelCount