Метод IXAudio2Voice::GetOutputMatrix (xaudio2.h)

Статья
03/13/2024

Возвращает уровень громкости каждого канала конечного вывода для голоса. Эти каналы сопоставляются с входными каналами указанного целевого голоса.

Синтаксис

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

Параметры

[in] pDestinationVoice

Указатель, указывающий целевой объект IXAudio2Voice для получения выходной матрицы.

Примечание Если голос отправляет в один целевой голос, то при указании значения NULL с этим целевым голосом будет работать GetOutputMatrix .

[in] SourceChannels

Подтверждает количество каналов вывода голоса. Это количество каналов, созданных последним эффектом в цепочке.

[in] DestinationChannels

Подтверждает количество входных каналов целевого голоса.

[out] pLevelMatrix

Массив уровней громкости [SourceChannels * DestinationChannels], отправленных в голос назначения. Уровень, отправляемый из исходного канала S в целевой канал D, возвращается в формате pLevelMatrix[DestinationChannels × S + D]. Дополнительные сведения об уровнях громкости см. в разделе Примечания.

Возвращаемое значение

Этот метод не возвращает значение.

Уровни громкости выражаются в виде амплитуды с плавающей запятой в диапазоне от -2 ⁴ до 2²⁴ с максимальным увеличением 144,5 дБ. Уровень громкости 1 означает отсутствие затухания или усиления, а 0 означает тишину. Отрицательные уровни можно использовать для инвертации фазы звука. Дополнительные сведения об управлении громкостей см. в разделе Управление громкости И шагом XAudio2 .

Сведения о стандартном порядке каналов см. в разделе WAVEFORMATEXTENSIBLE .

ПримечаниеGetOutputMatrix всегда возвращает уровни, недавно заданные IXAudio2Voice::SetOutputMatrix. Однако они могут еще не действовать: они вступают в силу только при следующем запуске звукового модуля после вызова IXAudio2Voice::SetOutputMatrix (или после соответствующего вызова IXAudio2::CommitChanges , если IXAudio2Voice::SetOutputMatrix был вызван с идентификатором отложенной операции).

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK Для DirectX (XAudio 2.7)

Требования

Требование	Значение
Целевая платформа	Windows
Header	xaudio2.h

См. также раздел

IXAudio2Voice

Поделиться через