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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |