IDirectMusic8::SetExternalMasterClock

The SetExternalMasterClock method sets the DirectMusic master clock to an existing clock object. There is only one master clock for all DirectMusic applications.

Syntax

HRESULT SetExternalMasterClock(
  IReferenceClock *pClock
);

Parameters

pClock

IReferenceClock interface pointer that specifies the clock.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return DMUS_E_PORTS_OPEN.

Remarks

If another running application is also using DirectMusic, it is not possible to change the master clock until that application is shut down.

Requirements

  Header: Declared in dmusicc.h.

See Also

• IDirectMusic8 Interface
• IDirectMusic8::EnumMasterClock
• IDirectMusic8::GetMasterClock
• IDirectMusic8::SetMasterClock
• Master Clock