IMFMediaEngineEx::SetTimelineMarkerTimer 메서드(mfmediaengine.h)

미디어 엔진이 마커 이벤트를 보낼 프레젠테이션 시간을 지정합니다.

구문

HRESULT SetTimelineMarkerTimer(
  [in] double timeToFire
);

매개 변수

[in] timeToFire

마커 이벤트의 프레젠테이션 시간(초)입니다.

반환 값

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

설명

재생이 timeToFire로 지정된 시간에 도달하면 미디어 엔진은 IMFMediaEngineNotify::EventNotify 메서드를 통해 MF_MEDIA_ENGINE_EVENT_TIMELINE_MARKER 이벤트를 보냅니다. 이 메서드를 호출하면 보류 중인 이전 표식이 취소됩니다.

애플리케이션이 마커 지점을 지나면 미디어 엔진이 마커를 취소하고 이벤트를 보내지 않습니다.

앞으로 재생하는 동안 timeToFire 를 현재 재생 위치보다 큰 값으로 설정합니다. 역방향 재생 중에 timeToFire 를 재생 위치보다 작은 값으로 설정합니다.

마커를 취소하려면 IMFMediaEngineEx::CancelTimelineMarkerTimer를 호출합니다.

요구 사항

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

추가 정보

IMFMediaEngineEx