| Microsoft DirectX 8.1 (C++) |
The IDirectMusicTrack8 interface represents a track object, which can store any kind of data for a segment.
The methods of this interface are typically not called directly by applications. However, if you want to install your own data playback mechanism in DirectMusic, you need to create a DirectMusic track object to represent it. The track object must also support the IPersistStream interface for loading its data.
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.
In addition to the methods inherited from IUnknown, the IDirectMusicTrack8 interface exposes the following methods.
| Method | Description |
| AddNotificationType | Enables event notification for a track. |
| RemoveNotificationType | Removes an event notification from a track. |
| Method | Description |
| GetParam | Retrieves data from a track, in music time. |
| GetParamEx | Retrieves data from a track, in either music or reference time. |
| IsParamSupported | Determines whether the track supports a given data type in the IDirectMusicTrack8::GetParam_dx_IDirectMusicTrack8_GetParam_dxaudio and IDirectMusicTrack8::SetParam_dx_IDirectMusicTrack8_SetParam_dxaudio methods. |
| SetParam | Sets data on a track, in music time. |
| SetParamEx | Sets data on a track, in either clock or music time. |
| Method | Description |
| EndPlay | Called when the object that originally called IDirectMusicTrack8::InitPlay_dx_IDirectMusicTrack8_InitPlay_dxaudio is destroyed. |
| InitPlay | Called when a track is ready to start playing. |
| Play | Called when the object that originally called IDirectMusicTrack8::InitPlay_dx_IDirectMusicTrack8_InitPlay_dxaudio is destroyed. |
| PlayEx | Causes the track to play in clock time. |
| Method | Description |
| Clone | Makes a copy of a track. |
| Compose | Recomposes the track based on data from a segment. |
| Init | Initializes the track. |
| Join | Appends one track to another. |
Requirements
Header: Declared in dmplugin.h.
See Also