Microsoft DirectX 8.0 (C++)

IDirectMusicTrack8

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.

Requirements

  Header: Declared in dmplugin.h.

See Also

DirectMusic Tracks, Setting and Retrieving Track Parameters