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 name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>SVC_UncompressRL*</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">SVC_UncompressRL* <IMG src="../image/NTR.gif" align="middle"><IMG src="../image/TWL.gif" align="middle"></h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/os/common/systemCall.h&gt;</CODE><BR>
20  <BR>
21  <CODE>void SVC_UncompressRL8( const void* srcp, void* destp );</CODE><br>
22  </dd>
23  <dd><CODE>s32 SVC_UncompressRL16FromDevice( const void* srcp,</CODE></dd>
24  <dd><CODE>                   void* destp,</CODE></dd>
25  <dd><CODE>                   const void* paramp,</CODE></dd>
26  <dd><CODE>                                      ReadStreamCallbacks *callbacks</CODE><CODE> );</CODE></dd>
27</dl>
28<h2>Arguments</h2>
29<TABLE border="1" width="100%">
30  <TBODY>
31    <TR>
32      <TD width="13%"><EM><STRONG>srcp</STRONG></EM></TD>
33      <TD width="87%">The source address where run length compressed data is stored.</TD>
34    </TR>
35    <TR>
36      <TD width="13%"><EM><STRONG>destp</STRONG></EM></TD>
37      <TD width="87%">Destination address for decompression.</TD>
38    </TR>
39    <TR>
40      <TD><EM><STRONG>paramp</STRONG></EM></TD>
41      <TD>Parameter address that is handed to the <code>initStream</code> function of the MIReadStreamCallBacks structure.</TD>
42    </TR>
43    <TR>
44      <TD><EM><STRONG>callbacks</STRONG></EM></TD>
45      <TD>Address of the <code>MIReadStreamCallbacks</code> socket.</TD>
46    </TR>
47  </TBODY>
48</TABLE>
49
50<h2>Return Values</h2>
51<p>There is no return value for <code>SVC_UncompressRL8()</code>.<BR> If the return value for <code>SVC_UncompressRL16FromDevice()</code> is greater than <code>0</code>, it is the decompressed size. If it is less than <code>0</code>, it is an error.</p>
52<H2>Description</H2>
53<P>This function decompresses run length compressed data and writes the data to the specified region of memory. Match the source address <em><strong><code>src</code></strong></em> to the 4-byte boundary. If the size of the compressed data is not a multiple of <code>4</code>, make adjustments by paring the size back using <code>0</code>.</P>
54<P>The <code>SVC_UncompressRL8()</code> function can be written in 8-bit units. You cannot decompress directly to VRAM().<BR> The <code>SVC_UncompressRL16FromDevice()</code> function can be written in 16-bit units. Compressed data on devices that are not memory mapped can be decompressed directly without using a temporary buffer.</P>
55<h2>See Also</h2>
56<p><code><a href="../mi/uncompress/MI_UncompressRL.html">MI_UncompressRL*</a>, <a href="SVC_UncompressLZ.html">SVC_UncompressLZ*</a>, <a href="SVC_UncompressHuffmanFromDevice.html">SVC_UncompressHuffmanFromDevice</a></code></p>
57
58<H2>Revision History</H2>
59<P>2004/07/22 Initial version.</P>
60<hr><p>CONFIDENTIAL</p></body>
61</html>
62