IDirectMusicObject8 Interface

The IDirectMusicObject8 interface is a generic object interface. All DirectMusic objects that can be loaded from a file or resource support the IDirectMusicObject8 interface so that they can work with the DirectMusic loader. New types of objects must implement this interface.

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.

In addition to the methods inherited from IUnknown, the IDirectMusicObject8 interface exposes the following methods.

Method Description
GetDescriptor Retrieves the object's internal description.
ParseDescriptor Given a file stream, scans the file for data that it can store in the DMUS_OBJECTDESC structure.
SetDescriptor Sets some or all members of the object's internal description.

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

typedef IDirectMusicObject __RPC_FAR *LPDMUS_OBJECT;

Requirements

**  Header:** Dmusici.h

See Also

© 2004 Microsoft Corporation. All rights reserved.