1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<title>SNDEX_SetVolumeSwitchCallback</title>
6<link rel="stylesheet" href="../../css/nitro.css" type="text/css">
7</HEAD>
8<BODY>
9<H1>SNDEX_SetVolumeSwitchCallback <IMG src="../../image/TWL.gif" width="24" height="12" border="0" align=middle></H1>
10
11<H2>Syntax</H2>
12<DL>
13<DD><CODE>#include &lt;twl/snd.h&gt;</CODE></DD>
14<DD><PRE><CODE>void SNDEX_SetVolumeSwitchCallback( SNDEXCallback callback, void* arg );</CODE></PRE></DD>
15</DL>
16
17<H2>Arguments</H2>
18<TABLE>
19<TBODY>
20<TR>
21<TH width="25%"><SPAN class="argument">callback</SPAN></TH>
22<TD width="75%"><A href="SNDEXCallback.html"><CODE>SNDEXCallback</CODE></A>-type function that will be notified when the volume button on the TWL console is pressed.</TD>
23</TR>
24<TR>
25<TH width="25%"><SPAN class="argument">arg</SPAN></TH>
26<TD width="75%">Argument to pass to the function specified in <SPAN class="argument">callback</SPAN>.</TD>
27</TR>
28</TBODY>
29</TABLE>
30<H2>Description</H2>
31<P>
32Sets the callback function to be notified when the volume button on the TWL console is pressed.
33</P>
34<P>
35Note that a PXI receive interrupt will send notification when the volume button is pressed, so callbacks will not occur if PXI receive interrupts are prohibited.
36</P>
37<P>
38If other processing related to extended sound features is running when the volume button is pressed, the callback will not occur.
39</P>
40
41<H2>Note</H2>
42<P>SNDEX functions cannot be used because exclusive control is used during callback execution. Returns <CODE>SNDEX_RESULT_EXCLUSIVE</CODE> even if called.
43
44<H2>See Also</H2>
45<P>
46<A href="SNDEXCallback.html"><CODE>SNDEXCallback</CODE></A>
47</P>
48
49<H2>Revision History</H2>
50<P>
512008/10/10 Standardized terminology and added information about restrictions when a callback is executing.<BR> 2008/06/30 Initial version.
52</P>
53<hr><p>CONFIDENTIAL</p></body>
54</HTML>