1<html>
2
3<head>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<LINK rel="stylesheet" type="text/css" href="../../../CSS/revolution.css">
6<title>THPAudioCreateHandle</title>
7</head>
8
9<body>
10
11<h1>THPAudioCreateHandle</h1>
12
13<h2>C Specification</h2>
14
15<dl>
16<dd><pre><code>#include &lt;win32/thpaudio.h&gt;</code></pre></dd>
17<dd><pre><code>THPAudioHandle* THPAudioCreateHandle(char* fileName, f32 framerate);</code></pre></dd>
18</dl>
19
20<h2>Arguments</h2>
21<table border="1" cellpadding="3" cellspacing="0.1">
22  <tr>
23<td width="120" bgcolor="#ffffe8"><strong><em><CODE>fileName</CODE></em></strong></td>
24<td width="520">File name of the conversion source WAV file.</td>
25  </tr>
26  <tr>
27<td width="120" bgcolor="#ffffe8"><strong><em><CODE>framerate</CODE></em></strong></td>
28<td width="520">Frame rate of the THP movie data. </td>
29  </tr>
30</table>
31
32<h2>Return Values</h2>
33<p>
34Returns a pointer to the <A href="THPAudioHandle.html"><code>THPAudioHandle</code></A> structure, if successful, and <code>NULL</code> otherwise.
35</p>
36
37<h2>Description</h2>
38<p>
39This function internally allocates a <A href="THPAudioHandle.html"><code>THPAudioHandle</code></A> structure using the <A href="../thpcore/THPMalloc.html"><code>THPMalloc</code></A> function. After opening the WAV file specified by <code>fileName</code>, the function gets the WAV file information and sets this information in the allocated <A href="THPAudioHandle.html"><code>THPAudioHandle</code></A> structure.
40</p>
41<p>
42Be sure to use the <A href="THPAudioFreeHandle.html"><code>THPAudioFreeHandle</code></A> function to release the <A href="THPAudioHandle.html"><code>THPAudioHandle</code></A> structure allocated with this function when the conversion to THP audio data completes.
43</p>
44
45<h2>See Also</h2>
46<p>
47<A href="THPAudioHandle.html"><code>THPAudioHandle</code></A>, <A href="../thpcore/THPMalloc.html"><code>THPMalloc</code></A>, <A href="THPAudioFreeHandle.html"><code>THPAudioFreeHandle</code></A>
48</p>
49
50<h2>Revision History</h2>
51<P>2006/03/01 Initial version.</P>
52<hr>
53<P>CONFIDENTIAL</p>
54</BODY>
55</HTML>