IMFPMediaPlayer::GetMediaItem 메서드(mfplay.h)

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

 

현재 미디어 항목에 대한 포인터를 가져옵니다.

구문

HRESULT GetMediaItem(
  [out] IMFPMediaItem **ppIMFPMediaItem
);

매개 변수

[out] ppIMFPMediaItem

미디어 항목의 IMFPMediaItem 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.

반환 값

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

반환 코드	설명
S_OK	메서드가 성공했습니다.
E_FAIL	현재 미디어 항목이 없습니다.
MF_E_NOT_FOUND	현재 미디어 항목이 없습니다.
MF_E_SHUTDOWN	개체의 Shutdown 메서드가 호출되었습니다.

설명

IMFPMediaPlayer::SetMediaItem 메서드는 비동기적입니다. 따라서 SetMediaItem 이 보류 중인 동안 GetMediaItem 은 방금 설정된 미디어 항목을 반환하지 않습니다. 대신 애플리케이션은 IMFPMediaPlayerCallback 인터페이스를 구현하고 MFP_EVENT_TYPE_MEDIAITEM_SET 이벤트를 처리해야 합니다. 자세한 내용은 플레이어에서 이벤트 수신을 참조하세요.

이전 설명은 MFPCreateMediaPlayer 함수에서 미디어 항목을 설정하는 데도 적용됩니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfplay.h

참고 항목

IMFPMediaPlayer

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