IXAudio2Voice::SetEffectChain 메서드(xaudio2.h)
음성의 효과 체인을 바꿉니다.
구문
\\HRESULT SetEffectChain(
[in, optional] const XAUDIO2_EFFECT_CHAIN *pEffectChain
);
매개 변수
[in, optional] pEffectChain
사용할 새 효과 체인을 설명하는 XAUDIO2_EFFECT_CHAIN 구조체에 대한 포인터입니다. NULL이 전달되면 현재 효과 체인이 제거됩니다.
반환 값
성공하면 S_OK 반환합니다. 그렇지 않으면 오류 코드입니다.
XAudio2 특정 오류 코드에 대한 설명은 XAudio2 오류 코드를 참조하세요.
설명
음성의 효과 체인에 허용되는 출력 채널 수는 음성을 만들 때 잠깁니다. 효과 체인을 사용하여 음성을 만드는 경우 SetEffectChain 에 전달된 모든 새 효과 체인에는 원래 효과 체인과 동일한 수의 입력 및 출력 채널이 있어야 합니다. 효과 체인 없이 음성을 만드는 경우 효과 체인에 허용되는 출력 채널 수는 기본적으로 음성의 입력 채널 수로 설정됩니다. 효과 체인 만들기에 실패한 부분이 있으면 적용되지 않습니다.
XAudio2 음성에 효과를 연결한 후 XAudio2는 효과를 제어하며 클라이언트는 더 이상 호출하지 않아야 합니다. 이를 보장하는 가장 간단한 방법은 효과에 대한 모든 포인터를 해제하는 것입니다.
콜백 내에서 SetEffectChain 을 호출하는 것은 잘못되었습니다(즉, IXAudio2EngineCallback 또는 IXAudio2VoiceCallback). 콜백 내에서 SetEffectChain 을 호출하면 XAUDIO2_E_INVALID_CALL 반환됩니다.
pEffectChain 인수로 전달되는 XAUDIO2_EFFECT_CHAIN 및 그 안에 포함된 XAUDIO2_EFFECT_DESCRIPTOR 정보는 SetEffectChain 이 성공적으로 완료된 후 더 이상 필요하지 않으며 SetEffectChain 이 호출된 직후에 삭제될 수 있습니다.
플랫폼 요구 사항
Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | xaudio2.h |