IMFPresentationTimeSource::GetUnderlyingClock 메서드(mfidl.h)
프레젠테이션 시간 원본이 시계 시간을 생성하는 데 사용하는 기본 클록을 검색합니다.
구문
HRESULT GetUnderlyingClock(
[out] IMFClock **ppClock
);
매개 변수
[out] ppClock
시계의 IMFClock 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 성공했습니다. |
|
이 시간 원본은 기본 클록을 노출하지 않습니다. |
설명
프레젠테이션 시간 원본은 중지, 시작, 일시 중지 및 속도 변경을 지원해야 합니다. 그러나 대부분의 경우 시간 원본은 하드웨어 시계 또는 다른 디바이스에서 시계 시간을 파생합니다. 기본 클록은 항상 실행 중이며 속도 변경을 지원하지 않을 수 있습니다.
필요에 따라 시간 원본은 이 메서드를 구현하여 기본 클록을 노출할 수 있습니다. 프레젠테이션 시간 원본이 일시 중지되거나 중지된 경우에도 기본 클록은 항상 실행됩니다. 따라서 기본 클록은 IMFClock::GetClockCharacteristics 메서드에서 MFCLOCK_CHARACTERISTICS_FLAG_ALWAYS_RUNNING 플래그를 반환합니다.
기본 클록은 프레젠테이션 시계가 중지되거나 일시 중지되는 동안 시계 시간에 따라 결정을 내리려는 경우에 유용합니다.
시간 원본이 기본 클록을 노출하지 않으면 메서드는 MF_E_NO_CLOCK 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | mfidl.h |
| 라이브러리 | Mfuuid.lib |