audio_free_play_queue

此函数用于释放与给定音频队列关联的内存。队列索引是使用函数audio_create_play_queue()创建队列时返回的值，当不再需要队列时应调用此函数以防止内存泄漏。释放队列将停止正在播放的任何声音，并且在释放声音所分配到的队列之前，您无法删除正在传输声音的缓冲区。

此函数将触发音频播放异步事件，在此事件中，将使用以下键/值对在变量async_load中创建一个特殊的DS 映射：

• "queue_id"已完成播放数据的队列
• "buffer_id"不再播放的缓冲区
• "queue_shutdown"在正常播放期间设置为 0，当收到事件时设置为 1，因为您已使用此函数释放队列。将其设置为 1 时，您不想将任何进一步数据排队。

语法:

audio_free_play_queue(queueIndex);

返回:

N/A

例子:

var q_id = async_load[? "queue_id"];
if (q_id == audio_queue)
{
    audio_free_play_queue(audio_queue);
    buffer_delete(audio_buffer);
}

上述代码将在异步音频回放事件中进行，并检查以查看已完成播放的音频是否来自"audio_queue"，如果是，则释放队列和与其关联的缓冲区。