다음을 통해 공유


IMFMediaEngineEx::InsertAudioEffect 메서드(mfmediaengine.h)

오디오 효과를 삽입합니다.

구문

HRESULT InsertAudioEffect(
  [in] IUnknown *pEffect,
  [in] BOOL     fOptional
);

매개 변수

[in] pEffect

다음 중 하나

  • 오디오 효과를 구현하는 MFT(Media Foundation 변환)의 IMFTransform 인터페이스에 대한 포인터입니다.
  • 활성화 개체의 IMFActivate 인터페이스에 대한 포인터입니다. 활성화 개체는 오디오 효과에 대한 MFT를 만들어야 합니다.

[in] fOptional

효과가 선택 사항인지 여부를 지정합니다.

의미
TRUE
효과는 선택 사항입니다. 미디어 엔진이 효과를 추가할 수 없는 경우 효과를 무시하고 재생을 계속합니다.
FALSE
효과가 필요합니다. Media Engine 개체가 효과를 추가할 수 없는 경우 재생 오류가 발생합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
성공.
MF_E_INVALIDREQUEST
최대 오디오 효과 수에 도달했습니다.

설명

효과는 다음 미디어 리소스가 로드될 때 적용됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfmediaengine.h

추가 정보

IMFMediaEngineEx