1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
6<title>AXSetVoicePriority</title>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
9<META http-equiv="Content-Style-Type" content="text/css">
10</head>
11
12<body>
13
14<h1 align="left">AXSetVoicePriority</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/ax.h&gt;
19
20#define AX_PRIORITY_NODROP  31
21#define AX_PRIORITY_LOWEST  1
22
23void AXSetVoicePriority(AXVPB *pvpb, u32 priority);
24</pre></dd></dl>
25
26<h2>Arguments</h2>
27<TABLE class="arguments" border="1" >
28  <tr>
29<th>pvpb</th>
30<td>Pointer to the voice.</td>
31  </tr>
32  <tr>
33<th><STRONG><EM><CODE>priority</CODE></EM></STRONG></th>
34<td>New priority for the voice. Set from <code>1</code> (minimum) - <code>31</code> (maximum). 31 is the highest priority. <code>AX_PRIORITY_NODROP</code> is defined as 31. <code>AX_PRIORITY_LOWEST</code> is defined as 1. Priority 0 means that the voice is empty.</td>
35  </tr>
36</table>
37
38<h2>Return Values</h2>
39<p>None.</p>
40
41<h2>Description</h2>
42<p>The <code>AXSetVoicePriority</code> function changes the priority for the specified voice. As an example, consider a synthesizer application that acquires a voice to produce a note in a score.&nbsp;Once the keyoff event is encountered, the voice enters the release phase and the priority of the voice may then be lowered to facilitate voice reacquisition.</p>
43
44<h2>See Also</h2>
45<p class="reference">
46<a href="AXAcquireVoice.html">AXAcquireVoice</a>
47</p>
48
49<h2>Revision History</h2>
50<P>
512006/03/01 Initial version.<BR>
52</P>
53
54<hr><p>CONFIDENTIAL</p></body>
55</html>
56