Edit

ISynthSinkDMus::SyncToMaster method (dmusicks.h)

  • Article

The SyncToMaster method allows synchronization to the master clock in order to avoid drift.

Syntax

NTSTATUS SyncToMaster(
  [in] REFERENCE_TIME rfTime,
  [in] BOOL           fStart
);

Parameters

[in] rfTime

Specifies the reference time from the master clock. Reference time is measured in 100-nanosecond units.

[in] fStart

Specifies whether the sample clock is to be reset to zero with this reference time. If TRUE, the sample clock must be reset to zero at time rtTime. If FALSE, the sample clock is not reset.

Return value

SyncToMaster returns STATUS_SUCCESS if the call was successful. Otherwise, the method returns an appropriate error code.

Remarks

Because the master time and sample time might be driven by different crystals, they can drift apart. The port driver periodically calls this method to give the miniport driver an opportunity to synchronize its sample clock to the master clock.

Parameter fStart is TRUE during the first call to SyncToMaster after the stream enters the KSSTATE_RUN state (see KSSTATE). Otherwise, fStart is FALSE.

Requirements

Requirement Value
Target Platform Desktop
Header dmusicks.h (include Dmusicks.h)

See also

ISynthSinkDMus

KSSTATE