Microsoft DirectX 8.0 (C++) |
The IDirectMusicTrack8 interface represents a track object. Almost everything that has to do with the definition of a segment is stored in its tracks. The track mechanism allows segments to be infinitely extensible, and the segment does not need any knowledge of any of the music and audio technologies that it employs.
If you plan to install your own music playback mechanism in DirectMusic, you need to create a DirectMusicTrack object to represent it. Otherwise, the methods of this interface are typically not called directly from the application.
IDirectMusicTrack8 supersedes the IDirectMusicTrack interface and adds new methods.
Note When implementing methods of the IDirectMusicTrack8 interface, be sure not to hold onto references to objects passed in. For example, if IDirectMusicTrack8::Init adds a reference to the IDirectMusicSegment interface that it receives as a parameter, ensure that this reference is released.
The IDirectMusicTrack8 interface has the following methods:
Creation | Clone |
Compose | |
Join | |
Initialization | Init |
Notification | AddNotificationType |
RemoveNotificationType | |
Parameters | GetParam |
GetParamEx | |
IsParamSupported | |
SetParam | |
SetParamEx | |
Playback | EndPlay |
InitPlay | |
Play | |
PlayEx |
All COM interfaces inherit the IUnknown interface methods. This interface supports the following three methods:
IUnknown | AddRef |
QueryInterface | |
Release |
The DirectMusicTrack object also supports the IDirectMusicObject8 and IPersistStream interfaces for loading its data.
Header: Declared in dmplugin.h.