/*
[API]
[
[DESCRIPTION]
Stops a song from playing.
[PARAMETERS]
'mod' Pointer to the song to be stopped.
[RETURN_VALUE]
void
[REMARKS]
[SEE_ALSO]
FMUSIC_PlaySong
]
*/
signed char FMUSIC_StopSong(FMUSIC_MODULE *mod)
{
if (!mod)
{
return FALSE;
}
// Kill the thread
FSOUND_Software_Exit = TRUE;
// wait until callback has settled down and exited
BLOCK_ON_SOFTWAREUPDATE();
if (FSOUND_Software_hThread)
{
while (!FSOUND_Software_ThreadFinished)
{
Sleep(10);
}
FSOUND_Software_hThread = NULL;
}
// remove the output mixbuffer
if (FSOUND_MixBufferMem)
{
FSOUND_Memory_Free(FSOUND_MixBufferMem);
FSOUND_MixBufferMem = 0;
}
if (FSOUND_MixBlock.wavehdr.lpData)
{
waveOutUnprepareHeader(FSOUND_WaveOutHandle, &FSOUND_MixBlock.wavehdr, sizeof(WAVEHDR));
FSOUND_MixBlock.wavehdr.dwFlags &= ~WHDR_PREPARED;
FSOUND_Memory_Free(FSOUND_MixBlock.wavehdr.lpData);
FSOUND_MixBlock.wavehdr.lpData = 0;
}
FMUSIC_PlayingSong = NULL;
if (FMUSIC_TimeInfo)
{
FSOUND_Memory_Free(FMUSIC_TimeInfo);
FMUSIC_TimeInfo = 0;
}
// ========================================================================================================
// SHUT DOWN OUTPUT DRIVER
// ========================================================================================================
waveOutReset(FSOUND_WaveOutHandle);
waveOutClose(FSOUND_WaveOutHandle);
FSOUND_Software_FillBlock = 0;
FSOUND_Software_RealBlock = 0;
return TRUE;
}
void FSOUND_File_Close(FSOUND_FILE_HANDLE *handle)
{
if (!handle)
return;
FSOUND_File_CloseCallback(handle->userhandle);
FSOUND_Memory_Free(handle);
}
signed char FMUSIC_FreeSongWithoutStop(FMUSIC_MODULE *mod)
{
int count;
if (!mod)
return FALSE;
// free samples
if (mod->instrument)
{
for (count=0; count<(int)mod->numinsts; count++)
{
int count2;
FMUSIC_INSTRUMENT *iptr = &mod->instrument[count];
for (count2=0; count2<iptr->numsamples; count2++)
{
if (iptr->sample[count2])
{
FSOUND_SAMPLE *sptr = iptr->sample[count2];
FSOUND_Memory_Free(sptr->buff);
FSOUND_Memory_Free(sptr);
}
}
}
}
// free instruments
if (mod->instrument)
{
FSOUND_Memory_Free(mod->instrument);
}
// free patterns
if (mod->pattern)
{
for (count=0; count<mod->numpatternsmem; count++)
{
if (mod->pattern[count].data)
{
FSOUND_Memory_Free(mod->pattern[count].data);
}
}
if (mod->pattern)
{
FSOUND_Memory_Free(mod->pattern);
}
}
// free song
FSOUND_Memory_Free(mod);
return TRUE;
}
FSOUND_FILE_HANDLE *FSOUND_File_Open(void *data, signed char type, int length)
{
FSOUND_FILE_HANDLE *handle;
handle = (FSOUND_FILE_HANDLE *)FSOUND_Memory_Alloc(sizeof(FSOUND_FILE_HANDLE));
handle->type = type;
handle->length = length;
handle->userhandle = FSOUND_File_OpenCallback(data);
if (!handle->userhandle)
{
FSOUND_Memory_Free(handle);
return NULL;
}
return(handle);
}
