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>THPUtyChangeAudioTrack</title>
7</head>
8
9<body>
10
11<h1>THPUtyChangeAudioTrack</h1>
12
13<h2>C Specification</h2>
14
15<dl>
16  <dd><pre><code>#include &lt;win32/thputilities.h&gt;</code></pre></dd>
17  <dd><pre><code>s32 THPUtyChangeAudioTrack(FILE*            iop,
18                           THPFileHeader*   fileHeader,
19                           THPAudioHandle** audioHandleList);</code></pre></dd>
20</dl>
21
22<h2>Arguments</h2>
23<table border="1" cellpadding="3" cellspacing="0.1">
24  <tr>
25<td width="120" bgcolor="#ffffe8"><strong><em><CODE>iop</CODE></em></strong></td>
26<td width="520">File pointer for the THP movie data for which the audio data is to be replaced.</td>
27  </tr>
28  <tr>
29<td width="120" bgcolor="#ffffe8"><strong><em><CODE>fileHeader</CODE></em></strong></td>
30<td width="520">Pointer to the <code>THPFileHeader</code> structure that stores THP header information.</td>
31  </tr>
32  <tr>
33<td width="120" bgcolor="#ffffe8"><strong><em><CODE>audioHandleList</CODE></em></strong></td>
34<td width="520">Pointer list for the <A href="../thpaudio/THPAudioHandle.html"><code>THPAudioHandle</code> structure</A> associated with the audio data to replace.</td>
35  </tr>
36</table>
37
38<h2>Return Values</h2>
39<p>
40Returns one of the following codes:
41</p>
42
43<table border="1">
44  <tbody>
45    <tr align="center">
46<td>code</td>
47<td width=50>value</td>
48<td>description</td>
49    </tr>
50    <tr>
51<td><CODE>THP_ERROR_NOERROR</CODE></td>
52      <td align="center">0</td>
53<td>The function ended normally.</td>
54    </tr>
55    <tr>
56<td><CODE>THP_ERROR_FILEIO</CODE></td>
57      <td align="center">1</td>
58<td>Failed to read or write from file. </td>
59    </tr>
60    <tr>
61<td><CODE>THP_ERROR_THPFILE</CODE></td>
62      <td align="center">2</td>
63<td>The THP movie data is invalid. </td>
64    </tr>
65  </tbody>
66</table>
67
68<h2>Description</h2>
69<p>
70This function replaces the audio track in the THP movie data specified by <code>iop</code> with the audio data specified by <code>audioHandleList</code>.
71</p>
72
73<h2>See Also</h2>
74<p>
75<A href="../thpaudio/THPAudioHandle.html"><code>THPAudioHandle</code></A>
76</p>
77
78<h2>Revision History</h2>
79<P>2006/03/01 Initial version.</P>
80<hr>
81<P>CONFIDENTIAL</p>
82</BODY>
83</HTML>