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

  • 아티클

미디어 원본 목록을 설정합니다.

구문

HRESULT SetSourceElements(
  [in] IMFMediaEngineSrcElements *pSrcElements
);

매개 변수

[in] pSrcElements

IMFMediaEngineSrcElements 인터페이스에 대한 포인터입니다. 호출자는 이 인터페이스를 구현해야 합니다.

반환 값

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

설명

이 메서드는 HTML5의 미디어 요소에 원본 요소 목록을 추가하는 데 해당합니다.

미디어 엔진은 성공적으로 로드되는 항목을 찾을 때까지 pSrcElements 목록의 각 항목을 로드하려고 합니다. 이 메서드가 호출된 후 애플리케이션은 IMFMediaEngineSrcElements 인터페이스를 사용하여 언제든지 목록을 업데이트할 수 있습니다. 목록을 다시 로드하려면 IMFMediaEngine::Load를 호출합니다.

이 메서드는 비동기적으로 완료됩니다. 작업이 시작되면 미디어 엔진은 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를 참조하세요.

애플리케이션이 IMFMediaEngine::SetSource도 호출하는 경우 SetSource 에 전달된 URL이 SetSourceElements에 지정된 목록보다 우선합니다.

요구 사항

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

참고 항목

IMFMediaEngine