alSndpDeallocate, n_alSndpDeallocate

Deallocates a sound from a sound player

Syntax

#include <libaudio.h>     /* libaudio.h */
void alSndpDeallocate(ALSndPlayer *sndp, ALSndId id);

#include <n_libaudio.h>     /* n_libaudio.h */
void n_alSndpDeallocate(                 ALSndId id);

Arguments

sndp

Pointer to a sound player

id

a unique number that identifies a sound within a sound player; it is returned by n_alSndpAllocate function when the sound is allocated to the sound player

Description

alSndpDeallocate deallocates a sound from a sound player specified by the sndp argument. It frees up space within the sound player. If the deallocated sound is the current target sound, the target ID is set to -1.

For details on n_audio library, see "Chapter 28: n_audio library" in the N64 Programming Manual.

Note

Call this function (alSndpDeallocate) for a sound only after that sound's state has reached AL_STOPPED.

See Also

alSndpSetSound, alSndpGetSound, and alSndpAllocate

Revision History

1999/04/30 Changed Format