Platform SDK: DirectX

IDirectMusicObject

All DirectMusic objects that can be loaded from a file support the IDirectMusicObject interface so that they can work with the DirectMusic loader. New types of objects need to implement this interface. For more information, see Custom Loading.

Most applications do not use the methods of this interface directly. However, IDirectMusicObject::GetDescriptor can be used to query an object for information, 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;

Requirements

  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