IWMReaderAdvanced::SetUserProvidedClock

The SetUserProvidedClock method specifies whether a user-driven clock is to be used.

Syntax

HRESULT SetUserProvidedClock(
  BOOL  fUserClock
);

Parameters

  fUserClock

[in]  Flag indicating the requirement for a user-driven clock.

Return Values

This method always returns S_OK.

Remarks

In some cases, an application built on this SDK requires the clock to be driven by the application rather than real time. This is true, for example, if you want to read from a file at a rate faster than it takes to play the file back.  User-driven clocks are only supported when the source file is a local file.

This call can fail if the current source does not support user-driven clocks. To drive a clock, an application must call DeliverTime, and then wait for the OnTime call on IWMReaderCallbackAdvanced to reach the time specified.

See Also

• IWMReaderAdvanced Interface
  
  
• IWMReaderAdvanced::GetUserProvidedClock