Microsoft DirectX 9.0 SDK Update (Summer 2004)

^{Standard Track Parameters}

This section describes the standard track parameters that can be set and retrieved by using the following methods.

• IDirectMusicPerformance8::GetParam
• IDirectMusicPerformance8::GetParamEx
• IDirectMusicPerformance8::SetParam
• IDirectMusicSegment8::GetParam
• IDirectMusicSegment8::SetParam
• IDirectMusicTrack8::GetParam
• IDirectMusicTrack8::GetParamEx
• IDirectMusicTrack8::SetParam
• IDirectMusicTrack8::SetParamEx

Parameter types are listed in this section under their GUIDs, as specified in the rGuidType parameter of the method call.

The following information is given for each parameter type:

Element	Description
Track type	Tracks to which the parameters apply. See Standard Track Types. Although parameters are always associated with particular tracks, applications usually call the method on the segment or the performance and let DirectMusic find the appropriate track. See Identifying the Track.
Data type	Type of data pointed to by the pParam parameter of the method call by which the parameter is set or retrieved.
mtTime	Significance, if any, of the mtTime parameter of the method call by which the parameter is set or retrieved.

The standard parameter types are listed in the following table.

Parameter GUID	Description
GUID_BandParam	Sets or retrieves a band.
GUID_ChordParam	Sets or retrieves a chord change.
GUID_Clear_All_Bands	Clears all bands from the track.
GUID_CommandParam	Sets or retrieves a groove or embellishment command.
GUID_CommandParam2	Sets or retrieves a groove or embellishment command, with additional timing information.
GUID_CommandParamNext	Sets or retrieves a groove or embellishment command to follow all other commands in the command track.
GUID_ConnectToDLSCollection	Connects all bands in the track to a DLS collection.
GUID_Disable_Auto_Download	Disables automatic downloading of instruments and waves.
GUID_DisableTempo	Disables tempo messages.
GUID_DisableTimeSig	Disables time signature messages.
GUID_Download	Downloads instrument data or wave data to the performance.
GUID_DownloadToAudioPath	Downloads instrument data or wave data to an audiopath.
GUID_Enable_Auto_Download	Enables automatic downloading of instruments and waves.
GUID_EnableTempo	Enables tempo messages.
GUID_EnableTimeSig	Enables time signature messages.
GUID_IDirectMusicBand	Sets a band.
GUID_IDirectMusicChordMap	Sets or retrieves the chordmap.
GUID_IDirectMusicStyle	Sets or retrieves the style.
GUID_MuteParam	Sets or retrieves channel-mapping and muting information.
GUID_Play_Marker	Retrieves the next point in the currently playing segment at which a new segment can start.
GUID_RhythmParam	Retrieves the rhythm pattern for a sequence of chords stored in a measure in the track.
GUID_SeedVariations	Seeds the random number generator for variation selection.
GUID_StandardMIDIFile	Ensures that a standard MIDI file plays correctly.
GUID_TempoParam	Sets or retrieves the tempo.
GUID_TimeSignature	Retrieves the time signature.
GUID_Unload	Unloads instrument or wave data from the performance.
GUID_UnloadFromAudioPath	Unloads instrument or wave data from an audiopath.
GUID_Valid_Start_Time	Retrieves the next valid point within a segment at which it can start.
GUID_Variations	Retrieves the variations in effect across performance channels.

---

© 2004 Microsoft Corporation. All rights reserved.