MFPCreateMediaPlayer 함수(mfplay.h)

  • 아티클
중요 되지 않는. 이 API는 향후 Windows 릴리스에서 제거될 수 있습니다. 애플리케이션은 재생을 위해 미디어 세션을 사용해야 합니다.
 

MFPlay 플레이어 개체의 새 instance 만듭니다.

구문

HRESULT MFPCreateMediaPlayer(
  [in]  LPCWSTR                 pwszURL,
  [in]  BOOL                    fStartPlayback,
  [in]  MFP_CREATION_OPTIONS    creationOptions,
  [in]  IMFPMediaPlayerCallback *pCallback,
  [in]  HWND                    hWnd,
  [out] IMFPMediaPlayer         **ppMediaPlayer
);

매개 변수

[in] pwszURL

열 미디어 파일의 URL을 포함하는 Null로 종료된 문자열입니다. 이 매개 변수는 NULL일 수 있습니다. 매개 변수가 NULL이면 fStartPlayback 은 FALSE여야 합니다.

이 매개 변수가 NULL인 경우 나중에 IMFPMediaPlayer::CreateMediaItemFromURL을 호출하여 URL을 열 수 있습니다.

[in] fStartPlayback

TRUE이면 재생이 자동으로 시작됩니다. FALSE이면 애플리케이션이 IMFMediaPlayer::P lay를 호출할 때까지 재생이 시작되지 않습니다.

pwszURL이 NULL이면 이 매개 변수는 무시됩니다.

[in] creationOptions

_MFP_CREATION_OPTIONS 열거형에서 더 많은 플래그의 비트 OR(0)입니다.

[in] pCallback

애플리케이션에서 구현한 콜백 개체의 IMFPMediaPlayerCallback 인터페이스에 대한 포인터입니다. MFPlay 플레이어 개체에서 이벤트 알림을 받으려면 이 인터페이스를 사용합니다. 이 매개 변수는 NULL일 수 있습니다. 매개 변수가 NULL이면 애플리케이션은 플레이어 개체에서 이벤트 알림을 받지 않습니다.

[in] hWnd

비디오가 표시되는 창에 대한 핸들입니다. 오디오 전용 재생의 경우 이 매개 변수는 NULL일 수 있습니다.

hWnd로 지정된 창은 원본에서 처음 선택한 비디오 스트림에 사용됩니다. 원본에 여러 비디오 스트림이 있는 경우 IMFPMediaItem::SetStreamSink 를 호출하여 첫 번째 비디오 스트림 이후에 비디오 스트림을 렌더링해야 합니다.

hWnd가 NULL인 경우 애플리케이션이 IMFPMediaItem::SetStreamSink를 호출하여 비디오 스트림에 대한 미디어 싱크를 지정하지 않는 한 MFPlay는 비디오를 표시하지 않습니다.

[out] ppMediaPlayer

IMFPMediaPlayer 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다. 이 매개 변수는 NULL일 수 있습니다. 이 매개 변수가 NULL인 경우 fStartPlayback 은 TRUE 이고 pwszURL 은 NULL일 수 없습니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수를 호출하기 전에 동일한 스레드에서 CoIntialize(Ex) 를 호출하여 COM 라이브러리를 초기화합니다.

내부적으로 MFPCreateMediaPlayer 는 MFStartup을 호출하여 Microsoft Media Foundation 플랫폼을 초기화합니다. 플레이어 개체가 제거되면 MFShutdown 을 호출하여 플랫폼을 종료합니다. MFPlay를 사용할 때 애플리케이션이 MFStartup 또는 MFShutdown 을 호출할 필요는 없습니다.

참고 플레이어 개체의 수명 시간 외에 다른 Media Foundation API를 사용하는 경우 애플리케이션은 MFStartup 및 MFShutdown을 호출해야 합니다.
 

요구 사항

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

추가 정보

미디어 파운데이션 함수

오디오/비디오 재생에 MFPlay 사용