IMFPresentationTimeSource::GetUnderlyingClock-Methode (mfidl.h)

Ruft die zugrunde liegende Uhr ab, die die Präsentationszeitquelle verwendet, um ihre Uhrzeiten zu generieren.

Syntax

HRESULT GetUnderlyingClock(
  [out] IMFClock **ppClock
);

Parameter

[out] ppClock

Empfängt einen Zeiger auf die IMFClock-Schnittstelle der Uhr. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_NO_CLOCK	Diese Zeitquelle macht keine zugrunde liegende Uhr verfügbar.

Hinweise

Eine Präsentationszeitquelle muss Das Beenden, Starten, Anhalten und Ratenänderungen unterstützen. In vielen Fällen leitet die Zeitquelle ihre Uhrzeiten jedoch von einer Hardwareuhr oder einem anderen Gerät ab. Die zugrunde liegende Uhr wird immer ausgeführt und unterstützt möglicherweise keine Ratenänderungen.

Optional kann eine Zeitquelle die zugrunde liegende Uhr verfügbar machen, indem sie diese Methode implementiert. Die zugrunde liegende Uhr wird immer ausgeführt, auch wenn die Quelle der Präsentationszeit angehalten oder beendet wird. (Daher gibt die zugrunde liegende Uhr das MFCLOCK_CHARACTERISTICS_FLAG_ALWAYS_RUNNING-Flag in der IMFClock::GetClockCharacteristics-Methode zurück.

Die zugrunde liegende Uhr ist nützlich, wenn Sie Entscheidungen basierend auf den Uhrzeiten treffen möchten, während die Präsentationsuhr angehalten oder angehalten wird.

Wenn die Zeitquelle keine zugrunde liegende Uhr verfügbar macht, gibt die Methode MF_E_NO_CLOCK zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mfuuid.lib

Weitere Informationen

IMFPresentationTimeSource

Präsentationsuhr