The information in this topic pertains only to applications written in C++. See Overview of DirectMusic Classes.

Certain types of objects, such as DirectMusicCollection and DirectMusicStyle, have to be loaded (typically from a file) before they can be incorporated into a music performance. Others, such as DirectMusicSegment, can be either loaded or constructed at run time. The interfaces introduced in this section are essential for loading.

Loader

The DirectMusicLoader object, through its IDirectMusicLoader interface, manages the enumeration, caching, and loading of objects.

Stream

Data being read from a file or resource is represented by a stream object. Most applications do not have to deal directly with streams, which are created and managed by the loader. The stream object implements the following two interfaces:

• IStream streams the data from a file or resource and passes it to the object being loaded, which parses it by using its own implementation of IPersistStream.
• IDirectMusicGetLoader has a single method that returns a pointer to the DirectMusicLoader object that created the stream. It is used when a reference to another object is found in a stream and the object being loaded needs to call the loader to load the referred to object.

For a closer look at the use of these interfaces in the loading process, see DirectMusic Loader.

Object

Every object in DirectMusic that represents a file or resource supports the IDirectMusicObject interface, which is used as a generic pointer by the loader. When an application has obtained a pointer to this interface, the IDirectMusicObject::QueryInterface method can be used to obtain a pointer to the object's own unique interface, such as IDirectMusicCollection or IDirectMusicStyle. However, you can usually obtain the interface that you need from the call to IDirectMusicLoader::GetObject.

The methods of IDirectMusicObject are used internally by the loader for identifying objects.