1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3
4<HEAD>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7
8    <LINK rel="stylesheet" href="./css/revolution.css" type="text/css">
9
10    <TITLE>HBMCreateSound</TITLE>
11<style type="text/css" media="all">
12<!--
13@import url("css/hbm_common.css");
14-->
15</style>
16</HEAD>
17<BODY>
18
19
20<H1>HBMCreateSound</H1>
21
22<H2>Syntax</H2>
23<dl><dd><pre><code>
24#include &lt;revolution/hbm.h&gt;
25
26void HBMCreateSound( const void* soundData, void* memBuf, u32 memSize );
27</code></pre></dd></dl>
28
29<H2>Arguments</H2>
30<TABLE border="1" >
31  <tr>
32    <TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>soundData</EM></STRONG></CODE></TD>
33    <TD width="520">Address of sound archive data.</TD>
34  </tr>
35  <tr>
36    <TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>memBuf</EM></STRONG></CODE></TD>
37    <TD width="520">The starting address of the buffer that stores the sound instance (this address must be 32-byte aligned).</TD>
38  </tr>
39  <tr>
40    <TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>memSize</EM></STRONG></CODE></TD>
41    <TD width="520">Size of memory allocated for the sound instance.</TD>
42  </tr>
43</TABLE>
44
45<H2>Return Values</H2>
46<P>
47None.
48</P>
49
50<H2>Description</H2>
51<P>
52Creates a sound instance.<br><br>In <span class="argument"><STRONG><CODE><EM>soundData</EM></CODE></STRONG></span>, pass the address of the sound archive data that is laid out in memory. Allocate the memory for storing a sound instance of the HOME Menu within the function. Set <span class="argument"><CODE><STRONG><EM>memSize</EM></STRONG></CODE></span> to a value greater than or equal to <CODE>HBM_MEM_SIZE_SOUND</CODE> (a value large enough to store a sound instance). Also, do not release after creation until <CODE>HBMDeleteSound</CODE> is called.
53</P>
54
55<H2>See Also</H2>
56<P>
57<code><A href="hbm_HBMDeleteSound.html"><CODE>HBMDeleteSound</CODE></A></code>
58</P>
59
60<H2>Revision History</H2>
61<DL class="history">
62    <DT>2007/10/26<DD>Revised the header explanation.
63  <DT>2007/05/09  <DD>Initial version.
64</DL>
65
66<hr><p>CONFIDENTIAL</p></body>
67</HTML>