MFCreateVideoRendererActivate 함수(mfidl.h)

향상된 EVR(비디오 렌더러) 미디어 싱크에 대한 활성화 개체를 만듭니다.

구문

HRESULT MFCreateVideoRendererActivate(
  [in]  HWND        hwndVideo,
  [out] IMFActivate **ppActivate
);

매개 변수

[in] hwndVideo

비디오가 표시될 창에 대한 핸들입니다.

[out] ppActivate

IMFActivate 인터페이스에 대한 포인터를 받습니다. 이 인터페이스를 사용하여 EVR을 만듭니다. 호출자는 인터페이스를 해제해야 합니다.

반환 값

함수는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.

설명

EVR을 만들려면 검색된 IMFActivate 포인터에서 IMFActivate::ActivateObject를 호출합니다. (미디어 세션을 사용하는 경우 토폴로지를 큐에 대기할 때 미디어 세션에서 ActivateObject 를 자동으로 호출합니다.)

EVR을 구성하려면 ActivateObject를 호출하기 전에 IMFActivate 개체에서 다음 특성을 설정합니다.

attribute	Description
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE	사용자 지정 믹서에 대한 활성화 개체입니다.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID	사용자 지정 믹서에 대한 CLSID입니다.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS	사용자 지정 믹서 만들기에 대한 플래그입니다.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE	사용자 지정 발표자에 대한 활성화 개체입니다.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID	사용자 지정 발표자용 CLSID입니다.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS	사용자 지정 발표자를 만들기 위한 플래그입니다.

 

IMFActivate::ActivateObject가 호출되면 활성화 개체는 IMFVideoDisplayControl::SetVideoPosition을 호출하여 EVR의 비디오 창을 설정합니다. hwndVideo 매개 변수에 대해 NULL을 전달하는 것은 오류가 아니지만 EVR에 유효한 비디오 창이 없는 한 비디오가 렌더링되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfidl.h
라이브러리	Mf.lib
DLL	Mf.dll

추가 정보

활성화 개체

향상된 비디오 렌더러

미디어 파운데이션 함수