IKsReferenceClock::GetCorrelatedTime method (ks.h)
The IKsReferenceClock::GetCorrelatedTime method queries the associated reference clock for current stream time and acquires the correlated system time.
Syntax
LONGLONG GetCorrelatedTime(
[out] PLONGLONG SystemTime
);
Parameters
[out] SystemTime
A pointer to a LONGLONG-typed variable that receives the current system time in 100 nanosecond units.
Return value
The IKsReferenceClock::GetCorrelatedTime method returns the stream time, specified by default in 100-nanosecond units. The correlated system time is returned in SystemTime.
Remarks
Use this method to determine the difference between stream time and system time. IKsReferenceClock::GetCorrelatedTime returns the times that both clocks show at the same moment.
For the most accurate results, call this method only when the stream is in a running state (KSSTATE_RUN) and not during a state transition.
You should use this method when obtaining a time stamp to put in the PresentationTime member of KSSTREAM_HEADER.
For more information, see AVStream Clocks.
AVStream uses the KSPROPERTY_CLOCK_CORRELATEDTIME property to retrieve the correlated time.
Requirements
Requirement | Value |
---|---|
Target Platform | Universal |
Header | ks.h (include Ks.h) |