Metode ISpatialAudioObject::SetVolume (spatialaudioclient.h)

Mengatur pengali amplitude audio yang akan diterapkan ke data audio yang disediakan oleh ISpatialAudioObject sebelum dikirimkan ke mesin penyajian audio.

Sintaks

HRESULT SetVolume(
  [in] float volume
);

Parameter

[in] volume

Pengali amplitude untuk data audio. Ini harus berupa nilai antara 0,0 dan 1,0.

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
SPTLAUDCLNT_E_OUT_OF_ORDER	ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects tidak dipanggil sebelum panggilan ke SetVolume.
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	SetEndOfStream dipanggil secara eksplisit atau implisit dalam pass pemrosesan audio sebelumnya. SetEndOfStream dipanggil secara implisit oleh sistem jika GetBuffer tidak dipanggil dalam pass pemrosesan audio (antara panggilan ke ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects dan ISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects).

Keterangan

Jika SetVolume tidak pernah dipanggil, nilai default 1.0 digunakan. Setelah SetVolume dipanggil, volume yang diatur akan digunakan untuk objek audio hingga volume diubah dengan panggilan lain ke SetVolume.

Persyaratan

Target Platform	Windows
Header	spatialaudioclient.h

Lihat juga

ISpatialAudioObject