IXAudio2Voice::D isableEffect 메서드(xaudio2.h)

음성의 효과 체인에서 지정된 위치에서 효과를 사용하지 않도록 설정합니다.

구문

\\HRESULT DisableEffect(
  [in] UINT32 EffectIndex,
  [in] UINT32 OperationSet
);

매개 변수

[in] EffectIndex

음성의 효과 체인에 있는 효과의 인덱스(0부터 시작)입니다.

[in] OperationSet

이 호출을 지연된 일괄 처리의 일부로 식별합니다. 자세한 내용은 XAudio2 작업 집합 개요를 참조하세요.

반환 값

성공하면 S_OK 반환합니다. 그렇지 않으면 오류 코드입니다. 유효한 오류 코드에 대한 설명은 XAudio2 오류 코드를 참조하세요.

설명

지정된 XAudio2 음성 효과 체인의 효과는 해당 음성의 처리 샘플 속도로 오디오를 사용하고 생성해야 합니다. 변경할 수 있는 오디오 형식의 유일한 측면은 채널 수입니다. 예를 들어 반향 효과는 모노 데이터를 5.1로 변환할 수 있습니다. 클라이언트는 XAUDIO2_EFFECT_DESCRIPTOR 구조체의 OutputChannels 필드를 사용하여 각 효과를 생성할 채널 수를 지정할 수 있습니다. 효과 체인의 각 효과는 다음 효과가 사용할 수 있는 여러 채널을 생성해야 합니다. 효과 체인이 이러한 요구 사항을 충족하지 못하게 하는 IXAudio2Voice::EnableEffect 또는 IXAudio2Voice::D isableEffect 에 대한 모든 호출은 실패합니다.

효과를 사용하지 않도록 설정하면 처리 그래프에서 즉시 제거됩니다. 효과의 보류 중인 오디오(예: 반향 꼬리)는 재생되지 않습니다. 효과를 호스트하는 음성이 실행되는 동안에는 효과를 사용하지 않도록 설정해야 합니다. 이로 인해 효과가 오디오의 피치 또는 볼륨을 크게 변경하는 경우 가청 아티팩트가 발생할 수 있습니다.

DisableEffect는 XAUDIO2_COMMIT_NOW OperationSet을 사용하여 XAudio2 콜백에서 호출되면 즉시 적용됩니다.

플랫폼 요구 사항

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

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	xaudio2.h

추가 정보

IXAudio2Voice

XAPO 개요