alSynFreeVoice.3p
785 Bytes
.TH alSynFreeVoice 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
alSynFreeVoice \- deallocate a synthesizer voice.
.SH SYNOPSIS
.nf
\f3
.Op c
#include <libaudio.h>
.sp .8v
void alSynFreeVoice(ALSynth *drvr, ALVoice *voice);
.Op
\f1
.fi
.SH PARAMETERS
.TP 10
.I drvr
pointer to the synthesizer driver.
.TP
.I voice
pointer to the voice structure.
.SH DESCRIPTION
Deallocate a synthesizer voice and return it to the free
voice list. Before calling alSynFreeVoice you should be sure the
sound has decayed to zero volume. Failure to insure that the volume
is at zero can result in clicks in the audio output.
.SH WARNING
alSynFreeVoice should only be called from within an ALVoiceHandler.
.SH SEE ALSO
.IR alSynAllocVoice (3P),
.IR alSynStartVoice (3P),
.IR alSynStopVoice (3P)