Initializing PortAudio

# Initializing PortAudio

Before making any other calls to PortAudio, you 'must' call Pa_Initialize(). This will trigger a scan of available devices which can be queried later. Like most PA functions, it will return a result of type paError. If the result is not paNoError, then an error has occurred.

err = Pa_Initialize();
if( err != paNoError ) goto error;
Pa_Initialize
PaError Pa_Initialize(void)

You can get a text message that explains the error message by passing it to Pa_GetErrorText( err ). For Example:

printf( "PortAudio error: %s\n", Pa_GetErrorText( err ) );
Pa_GetErrorText
const char * Pa_GetErrorText(PaError errorCode)

It is also important, when you are done with PortAudio, to Terminate it:

err = Pa_Terminate();
if( err != paNoError )
printf( "PortAudio error: %s\n", Pa_GetErrorText( err ) );
Pa_Terminate
PaError Pa_Terminate(void)

Previous: Writing a Callback Function | Next: Opening a Stream Using Defaults