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
17<h2>C Specification</h2>
18<BLOCKQUOTE>
19<pre><code>#include &lt;revolution.h&gt;
20
21#define AX_PRIORITY_NODROP  31
22#define AX_PRIORITY_LOWEST  1
23
24void AXSetVoicePriority(AXVPB *pvpb, u32 priority);</CODE></pre>
25</BLOCKQUOTE>
26<h2>Arguments</h2>
27
28<table border="1" cellpadding="3" cellspacing="0.1">
29  <tr>
30<td width="120" bgcolor="#ffffe8"><em><strong><code>pvpb</code></strong></em></td>
31<td width="520">Pointer to the voice.</td>
32  </tr>
33  <tr>
34<td width="120" bgcolor="#ffffe8"><em><strong><code>priority</code></strong></em></td>
35<td width="520">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>
36  </tr>
37</table>
38
39<h2>Return Values</h2>
40
41<p>None.</p>
42
43<h2>Description</h2>
44
45<p><code>AXSetVoicePriority()</code> 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>
46<h2>See Also</h2>
47
48<p>
49<code><a href="AXAcquireVoice.html">AXAcquireVoice</a></code>
50</p>
51
52<h2>Revision History</h2>
53
54<P>2006/03/01 Initial version.</P><hr>
55<P>CONFIDENTIAL</p>
56</BODY>
57</HTML>
58