Send a block full of data. (convenience routine)

int32 ssplSpoolData ( SoundSpooler *sspl, char *Data, int32 NumBytes, void *UserData )

ssplSpoolData() is a convenience function that does the following operations:

• Requests an available SoundBufferNode, returns 0 if none are available.
• Attaches sample data and optional user data pointer to the SoundBufferNode.
• Submits the SoundBufferNode to the active queue.

• sspl Pointer to a SoundSpooler structure.

• Data Pointer to the buffer of data.

• NumBytes Number of bytes of data to send.

• UserData Pointer to user data, or NULL.

Positive value on success indicating the signal to be sent when the buffer finishes playing, zero if no SoundBufferNodes are available, or negative 3DO error code for others kinds of failure.

Convenience call implemented in music.lib V21.

soundspooler.h, music.lib

ssplPlayData(), ssplRequestBuffer(), ssplSendBuffer(), ssplSetBufferAddressLength(), ssplSetUserData()