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

  • 아티클

현재 미디어 원본을 로드합니다.

구문

HRESULT Load();

반환 값

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

설명

이 메서드의 기본 목적은 목록을 업데이트한 후 원본 요소 목록을 다시 로드하는 것입니다. 자세한 내용은 SetSourceElements를 참조하세요. 그렇지 않으면 이 메서드를 호출할 필요가 없습니다. 새 미디어 원본을 로드하려면 IMFMediaEngine::SetSource 또는 IMFMediaEngine::SetSourceElements를 호출합니다.

Load 메서드는 미디어 엔진의 미디어 리소스 로드 알고리즘을 명시적으로 호출합니다. 이 메서드를 호출하기 전에 IMFMediaEngine::SetSource 또는 IMFMediaEngine::SetSourceElements를 호출하여 미디어 리소스를 설정해야 합니다.

이 메서드는 비동기적으로 완료됩니다. 로드 작업이 시작되면 미디어 엔진은 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
미디어 엔진이 파일을 로드할 수 없는 경우 미디어 엔진은 MF_MEDIA_ENGINE_EVENT_ERROR 이벤트를 보냅니다.

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

이 메서드는 HTML5에서 HTMLMediaElement 인터페이스의 로드 메서드에 해당합니다.

요구 사항

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

추가 정보

IMFMediaEngine