audio_create_play_queue

This function prepares a buffer queue for audio. You pass data format (only buffer_u8 or buffer_s16 are currently supported), the sample rate (which can be between 1000hz and 48000hz), and the channels that the audio requires from one of the constants listed below:

Note that you should free up any audio queues created with this function when no longer required to prevent memory leaks using the function audio_free_play_queue().

This function will trigger an Audio Playback Asynchronous Event when the queue has reached the end, and in this event a special DS map will be created in the variable async_load with the following key/value pairs:

• "queue_id" - the queue that has finished playing data
• "buffer_id" - the buffer that is no longer being played from
• "queue_shutdown" - this is set to 0 during normal playback and 1 when the event is received because audio_free_play_queue() has been called. When this is set to 1, you don't want to queue up any further data.

Syntax:

audio_create_play_queue(queueFormat, queueRate, queueChannels);

Returns:

Audio Queue ID

Example:

audio_queue = audio_create_play_queue(buffer_s16, 11052, audio_mono);

The above code creates a new audio queue and assigns its ID to a variable for future reference.