IMFPresentationClock::Start 메서드(mfidl.h)
프레젠테이션 시계를 시작합니다.
구문
HRESULT Start(
[in] LONGLONG llClockStartOffset
);
매개 변수
[in] llClockStartOffset
초기 시작 시간(100나노초 단위)입니다. Start 메서드가 호출되면 클록의 IMFPresentationClock::GetTime 메서드는 이 값을 반환하고 클록 시간은 여기에서 증가합니다. 값이 PRESENTATION_CURRENT_POSITION 클록은 현재 위치에서 시작됩니다. 시계가 일시 중지되고 동일한 위치에서 다시 시작하려는 경우 이 값을 사용합니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
반환 코드 | Description |
---|---|
|
메서드가 성공했습니다. |
|
이 시계에는 시간 원본이 설정되지 않았습니다. |
설명
이 메서드는 모든 상태(중지, 일시 중지 또는 실행 중)에서 유효합니다.
시계가 일시 중지되고 동일한 위치에서 다시 시작되면(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 |