IDirectMusicObject

All DirectMusic objects that can be loaded from a file support the IDirectMusicObject interface in order to work with the DirectMusic loader. In addition to providing a standard interface with which the loader can communicate, this interface provides a generic mechanism that allows an application to query an object for information about it, including its name, GUID, file path, and version.

The IDirectMusicObject interface must be obtained by calling another interface's QueryInterface method. It cannot be obtained by using CoCreateInstance.

The IDirectMusicObject interface has the following methods:

Descriptor GetDescriptor
  ParseDescriptor
SetDescriptor

All COM interfaces inherit the IUnknown interface methods. This interface supports the following three methods:

IUnknown AddRef
  QueryInterface
Release

The LPDMUS_OBJECT type is defined as a pointer to the IDirectMusicObject interface.

typedef IDirectMusicObject __RPC_FAR *LPDMUS_OBJECT;
 

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.

See Also

DirectMusic Loader, Custom Loading