Freigeben über


IDirectMusic8::GetMasterClock

Warning: This technology is deprecated as is all of DirectMusic. Deprecated components are considered obsolete. While these components are still supported, they may be removed in the future. When writing new applications, you should avoid using these deprecated components. When modifying existing applications, you are strongly encouraged to remove any dependency on these components.
Deprecated.

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

**  Minimum Supported Client:** Windows 2000.
**  Minimum Supported Server:** Windows 2000 Server.

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

See Also

© 2004 Microsoft Corporation. All rights reserved.