IDirectMusic8::GetMasterClock

The GetMasterClock method retrieves the GUID and a pointer to the IReferenceClock interface for the clock that is currently set as the DirectMusic master clock.

Syntax

HRESULT GetMasterClock(
  LPGUID  pguidClock,
  IReferenceClock**  ppReferenceClock
);

Parameters

pguidClock

Address of a variable that receives the GUID of the master clock. The application can pass NULL if this value is not desired.

ppReferenceClock

Address of a variable that receives the IReferenceClock interface pointer for this clock. The application can pass NULL if this value is not desired.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the error values shown in the following table.

Return code
E_NOINTERFACE
E_POINTER

Remarks

The IReferenceClock interface pointer must be released after the application has finished using the interface.

Requirements

**  Header:** Dmusicc.h
  Library: Dmusic.dll, Dmusicd.dll

See Also

© 2004 Microsoft Corporation. All rights reserved.