MFPCreateMediaPlayer 함수(mfplay.h)
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 을 호출할 필요는 없습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | mfplay.h |
라이브러리 | Mfplay.lib |
DLL | Mfplay.dll |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기