IXAudio2Voice::GetOutputMatrix 메서드(xaudio2.h)
음성에 대한 최종 출력의 각 채널 볼륨 수준을 가져옵니다. 이러한 채널은 지정된 대상 음성의 입력 채널에 매핑됩니다.
구문
\\ 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.5dB입니다. 볼륨 수준이 1이면 감쇠나 게인이 없고 0은 무음임을 의미합니다. 음수 수준은 오디오의 위상을 반전하는 데 사용할 수 있습니다. 볼륨 제어에 대한 자세한 내용은 XAudio2 볼륨 및 피치 컨트롤 을 참조하세요.
표준 채널 순서에 대한 자세한 내용은 WAVEFORMATEXTENSIBLE 을 참조하세요.
참고GetOutputMatrix 는 항상 IXAudio2Voice::SetOutputMatrix에서 가장 최근에 설정한 수준을 반환합니다. 그러나 실제로는 적용되지 않을 수 있습니다. 오디오 엔진은 다음에 IXAudio2Voice::SetOutputMatrix 호출 후(또는 해당 IXAudio2::CommitChanges 호출 후 , IXAudio2Voice::SetOutputMatrix 가 지연된 작업 ID로 호출된 경우) 다음에만 적용됩니다.
플랫폼 요구 사항
Windows 10(XAudio2.9); Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | xaudio2.h |