Add a file to the queue

Minimum required version: 1.37

=> | R0 = | 0
| R1 = | pointer to control-terminated filename

The named file is added to the end of the queue of files awaiting playback.

The file is passed though the format detector (as if PlayIt_Identify was used) to ensure the file exists and is playable. If an error occurs it is returned and the file is not queued. The queue request may also fail if the queue is full or there is no currently open file to queue after (the first file in a sequence must always be opened explicitly).

[ Parent ] [ Manual root ]