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

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

재생을 위해 미디어 항목을 큐에 대기합니다.

구문

HRESULT SetMediaItem(
  [in] IMFPMediaItem *pIMFPMediaItem
);

매개 변수

[in] pIMFPMediaItem

미디어 항목의 IMFPMediaItem 인터페이스에 대한 포인터입니다.

반환 값

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

반환 코드 설명
S_OK
 메서드가 성공했습니다.
E_INVALIDARG
 인수가 잘못되었습니다.
MF_E_DRM_UNSUPPORTED
 미디어 항목에 보호된 콘텐츠가 포함되어 있습니다. MFPlay는 현재 보호된 콘텐츠를 지원하지 않습니다.
MF_E_NO_AUDIO_PLAYBACK_DEVICE
 오디오 재생 장치를 찾을 수 없습니다. 이 오류는 미디어 원본에 오디오가 포함되어 있지만 시스템에서 오디오 재생 디바이스를 사용할 수 없는 경우에 발생할 수 있습니다.
MF_E_SHUTDOWN
 개체의 Shutdown 메서드가 호출되었습니다.

설명

이 메서드는 비동기적으로 완료됩니다. 작업이 완료되면 애플리케이션의 IMFPMediaPlayerCallback::OnMediaPlayerEvent 콜백 메서드가 호출됩니다. 이벤트 유형이 MFP_EVENT_TYPE_MEDIAITEM_SET.

미디어 항목을 만들려면 IMFPMediaPlayer::CreateMediaItemFromObject 또는 IMFPMediaPlayer::CreateMediaItemFromURL을 호출합니다. 미디어 항목은 해당 항목을 만든 동일한 MFPlay 플레이어 개체와 함께 사용해야 합니다. 플레이어 개체의 다른 instance 미디어 항목을 만든 경우 SetMediaItem은 E_INVALIDARG 반환합니다.

요구 사항

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

추가 정보

IMFPMediaPlayer

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