IMFCaptureSource::AddEffect 메서드(mfcaptureengine.h)

캡처 스트림에 효과를 추가합니다.

구문

HRESULT AddEffect(
  [in] DWORD    dwSourceStreamIndex,
  [in] IUnknown *pUnknown
);

매개 변수

[in] dwSourceStreamIndex

캡처 스트림입니다. 값은 다음 중 한 개일 수 있습니다.

의미
0-0xFFFFFFFB
스트림의 인덱스(0부터 시작)입니다. 스트림 수를 얻으려면 IMFCaptureSource::GetDeviceStreamCount를 호출합니다.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
첫 번째 이미지 스트림입니다.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
첫 번째 비디오 스트림입니다.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
첫 번째 오디오 스트림입니다.

[in] pUnknown

다음 중 하나에 대한 포인터입니다.

  • IMFTransform 인터페이스를 노출하는 MFT(Media Foundation 변환)입니다.
  • IMFActivate 인터페이스를 노출하는 MFT 활성화 개체입니다.

반환 값

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

반환 코드 Description
S_OK
성공.
MF_E_INVALIDMEDIATYPE
호환되는 미디어 유형을 찾을 수 없습니다.
MF_E_INVALIDSTREAMNUMBER
dwSourceStreamIndex 매개 변수가 잘못되었습니다.

설명

효과는 MFT( Media Foundation Transform )로 구현되어야 합니다. pUnknown 매개 변수는 MFT의 instance 또는 MFT에 대한 활성화 개체를 가리킬 수 있습니다. 자세한 내용은 활성화 개체를 참조하세요.

이 효과는 데이터가 캡처 싱크에 도달하기 전에 스트림에 적용됩니다.

요구 사항

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

추가 정보

IMFCaptureSource