Microsoft DirectX 9.0 SDK Update (Summer 2004)

^{Standard Track Types}

The following list describes the standard track types implemented by Microsoft DirectMusic. The class identifiers, such as CLSID_DirectMusicBandTrack, are used to identify track types in calls to various methods.

Track type	Class GUID	Purpose
Band	CLSID_DirectMusicBandTrack	Downloads DLS data to the performance. Sends messages of type DMUS_PATCH_PMSG, DMUS_TRANSPOSE_PMSG, DMUS_CHANNEL_PRIORITY_PMSG, and DMUS_MIDI_PMSG (for volume and pan). Used in segments based on MIDI files and styles.
Chord	CLSID_DirectMusicChordTrack	Used to convert music values in patterns to MIDI values. Sends messages of type DMUS_NOTIFICATION_PMSG (for GUID_NOTIFICATION_CHORD notifications).
Chordmap	CLSID_DirectMusicChordMapTrack	Used in template segments to compose chord tracks.
Command	CLSID_DirectMusicCommandTrack	Used in template segments to compose chord tracks, and in style segments to determine which patterns are played. Sends messages of type DMUS_NOTIFICATION_PMSG for GUID_NOTIFICATION_COMMAND notifications.
Lyrics	CLSID_DirectMusicLyricsTrack	Used to synchronize words with music. Generates messages of type DMUS_LYRIC_PMSG.
Marker	CLSID_DirectMusicMarkerTrack	Used for flow control. The marker track can hold valid start times for the segment, and play times at which new segments can be cued. For more information, see Segment Timing.
Motif	CLSID_DirectMusicMotifTrack	Used to play motifs to accompany other segments. Sends messages of type DMUS_CURVE_PMSG, DMUS_NOTE_PMSG, and DMUS_NOTIFICATION_PMSG (for GUID_NOTIFICATION_MEASUREANDBEAT notifications).
Mute	CLSID_DirectMusicMuteTrack	Enables performance channels to be remapped or muted. Used with either style-based or MIDI-based segments.
Parameter control	CLSID_DirectMusicParamControlTrack	Controls the settings on tools, effects, and any other objects that support the IMediaParams interface.
Pattern	CLSID_DirectMusicPatternTrack	Contains a single musical pattern. The pattern track is similar to a sequence track, but contains music values rather than fixed notes. This track makes it possible to audition a pattern against different chords, and is used mostly by music-authoring applications. It might also be used to play an accompaniment. It is represented by its own interface, IDirectMusicPatternTrack8.
Script	CLSID_DirectMusicScriptTrack	Calls routines in an audio script.
Segment trigger	CLSID_DirectMusicSegmentTriggerTrack	Triggers the playback of segments. This track enables the author of a file to cue a segment from within a segment, rather than leaving this up to the application developer.
Sequence	CLSID_DirectMusicSeqTrack	Sends sequence messages of type DMUS_NOTE_PMSG and DMUS_MIDI_PMSG. Used in segments based on MIDI files. Also sends messages of type DMUS_CURVE_PMSG for segments saved in the .sgt format.
Signpost	CLSID_DirectMusicSignPostTrack	Used in template segments to compose chord tracks.
Style	CLSID_DirectMusicStyleTrack	Fundamental track for segments based on styles. Sends messages of type DMUS_TIMESIG_PMSG, DMUS_CURVE_PMSG, DMUS_NOTE_PMSG, and DMUS_NOTIFICATION_PMSG (for GUID_NOTIFICATION_MEASUREANDBEAT notifications).
SysEx	CLSID_DirectMusicSysExTrack	Sends system exclusive messages of type DMUS_SYSEX_PMSG. Used in segments based on MIDI files.
Tempo	CLSID_DirectMusicTempoTrack	Controls the tempo of the performance.
Time Signature	CLSID_DirectMusicTimeSigTrack	Sends messages of type DMUS_TIMESIG_PMSG as well as GUID_NOTIFICATION_MEASUREANDBEAT notifications. The time signature track exists in imported MIDI files and authored 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. The Time Signature track supports the IDirectMusicTrack interface, but not IDirectMusicTrack8.
Wave	CLSID_DirectMusicWaveTrack	Sends messages of type DMUS_WAVE_PMSG to play time-stamped wave sounds.

---

© 2004 Microsoft Corporation. All rights reserved.