alSndpSetPriority.3p
796 Bytes
.TH alSndpSetPriority 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
alSndpSetPriority \- set the priority of a sound
.SH SYNOPSIS
.nf
\f3
.Op c
#include <libaudio.h>
.sp .8v
void alSndpSetPriority(ALSndPlayer *sndp, ALSndId id, u8 priority);
.Op
\f1
.fi
.SH PARAMETERS
.TP 10
.I sndp
pointer to a sound player.
.TP
.I id
id of the sound returned when the sound is allocated by
.IR alSndpAllocate.
.TP
.I priority
sound priority.
.SH DESCRIPTION
Set the priority of a sound. The sound priority is mapped directly to a
voice priority in the Synthesis Driver when the sound is played.
When new requests for
voices are made to the Synthesis Driver (when a sound or note is played),
lower priority voices will be stolen if there are no free voices.
.SH SEE ALSO
.IR alSndpAllocate (3P).