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 . |