Metode IXAudio2Voice::GetOutputMatrix (xaudio2.h)

Artikel
03/13/2024

Mendapatkan tingkat volume setiap saluran output akhir untuk suara. Saluran ini dipetakan ke saluran input dari suara tujuan tertentu.

Sintaks

\\ void GetOutputMatrix(
  [in]  IXAudio2Voice *pDestinationVoice,
  [in]  UINT32        SourceChannels,
  [in]  UINT32        DestinationChannels,
  [out] float         *pLevelMatrix
);

Parameter

[in] pDestinationVoice

Penunjuk yang menentukan tujuan IXAudio2Voice untuk mengambil matriks output.

Catatan Jika suara dikirim ke satu suara target, maka menentukan NULL akan menyebabkan GetOutputMatrix beroperasi pada suara target tersebut.

[in] SourceChannels

Mengonfirmasi jumlah saluran output suara. Ini adalah jumlah saluran yang diproduksi oleh efek terakhir dalam rantai.

[in] DestinationChannels

Mengonfirmasi jumlah saluran input suara tujuan.

[out] pLevelMatrix

Array tingkat volume [SourceChannels * DestinationChannels] yang dikirim ke suara tujuan. Tingkat yang dikirim dari saluran sumber S ke saluran tujuan D dikembalikan dalam bentuk pLevelMatrix[DestinationChannels × S + D]. Lihat Keterangan untuk informasi selengkapnya tentang tingkat volume.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Metode ini hanya berlaku untuk suara sumber dan submix, karena suara master menulis langsung ke perangkat tanpa pencampuran matriks.

Tingkat volume dinyatakan sebagai pengali ampli titik mengambang antara -2²⁴ hingga 2²⁴, dengan perolehan maksimum 144,5 dB. Tingkat volume 1 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.

Lihat WAVEFORMATEXTENSIBLE untuk informasi tentang pemesanan saluran standar.

CatatanGetOutputMatrix selalu mengembalikan level yang terakhir ditetapkan oleh IXAudio2Voice::SetOutputMatrix. Namun, mereka mungkin belum benar-benar berlaku: mereka hanya berlaku saat mesin audio berjalan setelah panggilan IXAudio2Voice::SetOutputMatrix (atau setelah panggilan IXAudio2::CommitChanges yang sesuai, jika IXAudio2Voice::SetOutputMatrix 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

IXAudio2Voice

Bagikan melalui