IKsReferenceClock::GetCorrelatedTime-Methode (ks.h)
Die IKsReferenceClock::GetCorrelatedTime-Methode fragt die zugeordnete Referenzuhr für die aktuelle Streamzeit ab und ruft die korrelierte Systemzeit ab.
Syntax
LONGLONG GetCorrelatedTime(
[out] PLONGLONG SystemTime
);
Parameter
[out] SystemTime
Ein Zeiger auf eine LONGLONG-typisierte Variable, die die aktuelle Systemzeit in 100 Nanosekundeneinheiten empfängt.
Rückgabewert
Die IKsReferenceClock::GetCorrelatedTime-Methode gibt die Streamzeit zurück, die standardmäßig in Einheiten von 100 Nanosekunden angegeben ist. Die korrelierte Systemzeit wird in SystemTime zurückgegeben.
Hinweise
Verwenden Sie diese Methode, um den Unterschied zwischen Streamzeit und Systemzeit zu bestimmen. IKsReferenceClock::GetCorrelatedTime gibt die Zeiten zurück, die beide Uhren zum selben Zeitpunkt anzeigen.
Um die genauesten Ergebnisse zu erzielen, rufen Sie diese Methode nur auf, wenn sich der Stream in einem ausgeführten Zustand (KSSTATE_RUN) befindet und nicht während eines Zustandsübergangs.
Sie sollten diese Methode verwenden, wenn Sie einen Zeitstempel abrufen, um den PresentationTime-Member von KSSTREAM_HEADER.
Weitere Informationen finden Sie unter AVStream-Uhren.
AVStream verwendet die KSPROPERTY_CLOCK_CORRELATEDTIME-Eigenschaft , um die korrelierte Zeit abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |