IMFPresentationClock::Start 메서드(mfidl.h)

  • 아티클

프레젠테이션 시계를 시작합니다.

구문

HRESULT Start(
  [in] LONGLONG llClockStartOffset
);

매개 변수

[in] llClockStartOffset

초기 시작 시간(100나노초 단위)입니다. Start 메서드가 호출되면 클록의 IMFPresentationClock::GetTime 메서드는 이 값을 반환하고 클록 시간은 여기에서 증가합니다. 값이 PRESENTATION_CURRENT_POSITION 클록은 현재 위치에서 시작됩니다. 시계가 일시 중지되고 동일한 위치에서 다시 시작하려는 경우 이 값을 사용합니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 성공했습니다.
MF_E_CLOCK_NO_TIME_SOURCE
 이 시계에는 시간 원본이 설정되지 않았습니다.

설명

이 메서드는 모든 상태(중지, 일시 중지 또는 실행 중)에서 유효합니다.

시계가 일시 중지되고 동일한 위치에서 다시 시작되면(llClockStartOffset 이 PRESENTATION_CURRENT_POSITION), 프레젠테이션 시계는 IMFClockStateSink::OnClockRestart 알림을 보냅니다. 그렇지 않으면 시계가 IMFClockStateSink::OnClockStart 알림을 보냅니다.

프레젠테이션 클록은 시계의 시간 원본 에서 OnClockStart 또는 OnClockRestart 를 호출하여 상태 변경을 시작합니다. 이 호출은 동기적으로 수행됩니다. 실패하면 상태 변경이 발생하지 않습니다. 호출이 성공하면 상태가 변경되고 시계는 OnClockStart 또는 OnClockRestart 메서드를 호출하여 다른 상태 변경 구독자에게 알릴 수 있습니다. 이러한 호출은 비동기적으로 이루어집니다.

시계가 이미 실행 중인 경우 시작을 다시 호출하면 새 StartOffset 위치로 클록을 찾는 효과가 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfidl.h
라이브러리 Mfuuid.lib

추가 정보

IMFPresentationClock

프레젠테이션 시계