Microsoft DirectX 8.0 (C++)

IDirectMusicObject8

All DirectMusic objects that can be loaded from a file support the IDirectMusicObject8 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, IDirectMusicObject8::GetDescriptor can be used to query an object for information, including its name, GUID, file path, and version.

The IDirectMusicObject8 interface is usually obtained by calling another interface's QueryInterface method. It cannot be obtained by using CoCreateInstance. The interface is also returned by IDirectMusicContainer8::EnumObject.

IDirectMusicObject8 is a define for IDirectMusicObject. The two interface names are interchangeable.

The IDirectMusicObject8 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

  Header: Declared in dmusici.h.

See Also

Loading Audio Data, Custom Loading