IMFMediaEngine::SetSource 메서드(mfmediaengine.h)

미디어 리소스의 URL을 설정합니다.

구문

HRESULT SetSource(
  [in] BSTR pUrl
);

매개 변수

[in] pUrl

미디어 리소스의 URL입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 HTML5에서 HTMLMediaElement 인터페이스의 src 특성을 설정하는 데 해당합니다.

이 메서드에서 지정한 URL이 IMFMediaEngine::SetSourceElements 메서드에 지정된 미디어 리소스보다 우선합니다. URL을 로드하려면 IMFMediaEngine::Load를 호출합니다.

이 메서드는 URL을 비동기적으로 로드합니다. 작업이 시작되면 미디어 엔진은 MF_MEDIA_ENGINE_EVENT_LOADSTART 이벤트를 보냅니다. 로드 작업 중에 오류가 발생하지 않으면 다음을 비롯한 여러 다른 이벤트가 생성됩니다.

  • MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
  • MF_MEDIA_ENGINE_EVENT_LOADEDDATA
  • MF_MEDIA_ENGINE_EVENT_CANPLAY
  • MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH
미디어 엔진이 URL을 로드할 수 없는 경우 미디어 엔진은 MF_MEDIA_ENGINE_EVENT_ERROR 이벤트를 보냅니다.

미디어 엔진의 이벤트 처리에 대한 자세한 내용은 IMFMediaEngineNotify를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfmediaengine.h

참고 항목

IMFMediaEngine