Metode IXAudio2Voice::SetVolume (xaudio2.h)

Artikel
03/04/2024

Mengatur tingkat volume keseluruhan untuk suara.

Sintaks

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

Parameter

[in] Volume

Tingkat volume keseluruhan yang akan digunakan. Lihat Keterangan untuk informasi selengkapnya tentang tingkat volume.

[in] OperationSet

Mengidentifikasi panggilan ini sebagai bagian dari batch yang ditangguhkan. Lihat gambaran umum XAudio2 Operation Sets untuk informasi selengkapnya.

Nilai kembali

Mengembalikan S_OK jika berhasil, kode kesalahan sebaliknya. Lihat Kode Kesalahan XAudio2 untuk deskripsi kode kesalahan.

Keterangan

SetVolume mengontrol tingkat volume input master suara. Tingkat volume master diterapkan pada waktu yang berbeda tergantung pada jenis suara. Untuk submix dan suara master, tingkat volume diterapkan tepat sebelum rantai filter dan efek bawaan suara diterapkan. Untuk suara sumber, tingkat volume master diterapkan setelah filter dan rantai efek suara diterapkan.

Tingkat volume dinyatakan sebagai pengali ampli titik mengambang antara -XAUDIO2_MAX_VOLUME_LEVEL dan XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ hingga 2²⁴), dengan perolehan maksimum 144,5 dB. Tingkat volume 1,0 berarti tidak ada redaman atau perolehan dan 0 berarti keheningan. Tingkat negatif dapat digunakan untuk menginversi fase audio. Lihat Volume XAudio2 dan Kontrol Pitch untuk informasi tambahan tentang kontrol volume.

CatatanIXAudio2Voice::GetVolume selalu mengembalikan volume yang terakhir ditetapkan oleh IXAudio2Voice::SetVolume. Namun, mungkin belum benar-benar berlaku: ini hanya berlaku saat mesin audio berjalan setelah panggilan IXAudio2Voice::SetVolume (atau setelah panggilan IXAudio2::CommitChanges yang sesuai, jika IXAudio2Voice::SetVolume dipanggil dengan ID operasi yang ditangguhkan).

Persyaratan Platform

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	xaudio2.h

Lihat juga

Cara: Mengubah Volume Suara

Cara: Menggunakan Submix Voices

IXAudio2Voice

Bagikan melalui