OpenSoundFile
Creates a SoundFilePlayer data structure and loads a sound file.
Synopsis
SoundFilePlayer *OpenSoundFile( char *FileName,int32 NumBuffers, int32 BufSize )
Description
This is a convenience function that creates a SoundFilePlayer data structure and loads the sound file. It calls CreateSoundFilePlayer() and LoadSoundFile() for you.
Arguments
- FileName
- A pointer to the name of the sound file.
- NumBuffers
- A value indicating the number of audio data buffers in the SoundFilePlayer.
- BufSize
- A value indicating the size of the audio data buffers.
Return Value
This function returns a pointer to the SoundFilePlayer data structure if successful or NULL if an error occurs.
Implementation
Convenience call implemented in music.lib V20.
Caveats
Buffer size must be a multiple of the file's block size (see LoadSoundFile() for complete reason).
Associated Files
soundfile.h, music.lib
See Also
CloseSoundFile(), DeleteSoundFilePlayer(), LoadSoundFile(), ReadSoundFile(), RewindSoundFile(), ServiceSoundFile(), StartSoundFile(), StopSoundFile(), UnloadSoundFile() CreateSoundFilePlayer()