Opening the Audio Folio

The Audio folio is started at bootup. To make Audio folio calls, a task must first open the Audio folio with this call:

Err OpenAudioFolio( void )

The call accepts no arguments and returns 0 if successful. If unsuccessful, it returns a negative number (an error code). On execution, OpenAudioFolio() connects the task to the Audio folio and sets up a pointer table for each of the audio calls.

If you do not open the Audio folio before you use audio calls, your task will abort and an error message will be displayed. Keep this in mind if your program dies the first time it encounters an audio call and you are sure that you have used the call correctly.