CreateScoreContext

Allocates a score context.

Synopsis

ScoreContext *CreateScoreContext( int32 MaxNumPrograms )

Description

This function allocates and initializes a score context with room enough for n MIDI programs. It also creates a default PIMap for the score context. The score context is necessary to import a MIDI score from a disc file and then play back that file.

Arguments

MaxNumPrograms
The maximum number of MIDI programs (1128) for which memory will be allocated within the score context.

Return Value

Returns a pointer to a new ScoreContext on success; NULL on failure.

Implementation

Library call implemented in music.lib V20.

Associated Files

score.h, music.lib

See Also

InitScoreDynamics(), InitScoreMixer(), ChangeScoreControl() TermScoreMixer(), ChangeScoreProgram(), DeleteScoreContext()