IDirectMusicTrack

The IDirectMusicTrack 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 doesn't have to have any knowledge about any of the music and audio technologies that it employs.

If you plan to install your own music playback mechanism into DirectMusic, you will need to create a DirectMusicTrack object to represent it. Otherwise, the methods of this interface will typically not be called directly from the application.

Note  When implementing methods of the IDirectMusicTrack interface, you must take care not to hold onto references to objects passed in. For example, if IDirectMusicTrack::Init adds a reference to the IDirectMusicSegment it receives as a parameter, you must ensure that this reference is released.

The IDirectMusicTrack interface has the following methods:

All COM interfaces inherit the IUnknown interface methods. This interface supports the following three methods:

The DirectMusicTrack object also supports the IDirectMusicObject and IPersistStream interfaces for loading its data.

The following table shows which methods are supported by the standard track types. For a general description of the standard types, see Tracks.

Notes  * The method returns a value other than E_NOTIMPL but does not do anything else.

** The time signature track exists in imported MIDI files and DirectMusic Producer segments specifically created with one. In most cases the style track implements the time signature track's functionality, so it is not necessary for a segment that contains a style track to contain a time signature track as well.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.

See Also

Tracks, Setting and Retrieving Track Parameters