CBaseReferenceClock.GetTime-Methode

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die GetTime -Methode ruft die aktuelle Referenzzeit ab. Diese Methode implementiert die IReferenceClock::GetTime-Methode .

Syntax

HRESULT GetTime(
   REFERENCE_TIME *pTime
);

Parameter

pTime

Zeiger auf eine Variable, die die aktuelle Zeit in 100 Nanosekundeneinheiten empfängt.

Rückgabewert

Gibt einen der in der folgenden Tabelle gezeigten HRESULT-Werte zurück.

Rückgabecode Beschreibung
E_POINTER
 NULL-Zeigerargument.
S_FALSE
 Die zurückgegebene Zeit entspricht dem vorherigen Wert.
S_OK
 Erfolg.

Bemerkungen

Diese Methode ruft die CBaseReferenceClock::GetPrivateTime-Methode auf, um die Echtzeitzeit zu bestimmen. Wenn die Uhrzeit streng größer als der vorherige Wert ist, GetTime verwendet die Uhrzeit und gibt S_OK zurück. GetTime Verwendet andernfalls den vorherigen Wert und gibt S_FALSE zurück. Daher kann die interne Uhr für einen kurzen Zeitraum rückwärts ausgeführt werden, ohne dass die Referenzzeit rückwärts ausgeführt wird. Stattdessen wird die Referenzzeit beim gleichen Wert "angehalten", bis die interne Uhr aufgeholt wird.

Anforderungen

Anforderung Wert
Header
Refclock.h (Einschließen von Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseReferenceClock-Klasse