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:** Dmusicc.h
  Library: Dmusic.dll, Dmusicd.dll

See Also

© 2004 Microsoft Corporation. All rights reserved.