This topic has not yet been rated - Rate this topic

IKsReferenceClock::GetCorrelatedTime method

The IKsReferenceClock::GetCorrelatedTime method queries the associated reference clock for current stream time and acquires the correlated system time.

Syntax

C++


LONGLONG GetCorrelatedTime(
  [out]  PLONGLONG SystemTime
);

Parameters

SystemTime [out]: 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