# 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()`