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 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>CXReadUncompLRC</title>
9<LINK rel="stylesheet" href="../CSS/revolution.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">CXReadUncompLRC</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19  <PRE><CODE>#include &lt;revolution/cx/CXStreamingUncompression.h&gt;</CODE><BR>
20
21<CODE>s32 CXReadUncompLRC( <A href="CXUncompContextLRC.html">CXUncompContextLRC</A> *context,
22                     const void*       data,
23                     u32               len );</CODE></PRE>
24  </dd>
25</dl>
26<h2>Arguments</h2>
27<TABLE border="1" width="100%">
28  <TBODY>
29    <TR>
30<TD width="13%"><EM><STRONG>context</STRONG></EM></TD>
31<TD width="87%">Pointer to the context structure for uncompression of LRC-compressed data.</TD>
32    </TR>
33    <TR>
34<TD width="13%"><EM><STRONG>data</STRONG></EM></TD>
35<TD width="87%">Pointer to the next data in the file being decompressed.</TD>
36    </TR>
37    <TR>
38<TD><EM><STRONG>len</STRONG></EM></TD>
39<TD>Size of the data provided in the 2nd argument.</TD>
40    </TR>
41  </TBODY>
42</TABLE>
43
44<h2>Return Values</h2>
45<p>Returns a positive value if data remains to be uncompressed, and a negative error code if an error has occurred.<BR>If all data was successfully decompressed, the function returns 0.</p>
46<TABLE border="1" width="100%">
47  <TBODY>
48    <TR>
49<TD width="13%"><EM><STRONG>Positive integer</STRONG></EM></TD>
50<TD width="87%">Number of bytes not yet decompressed.</TD>
51    </TR>
52    <TR>
53<TD width="13%"><EM><STRONG>CX_ERR_SUCCESS</STRONG></EM></TD>
54<TD width="87%">Ended normally (==0).</TD>
55    </TR>
56    <TR>
57<TD width="13%"><EM><STRONG>CX_ERR_UNSUPPORTED</STRONG></EM></TD>
58<TD width="87%">Unsupported compression data type.</TD>
59    </TR>
60    <TR>
61<TD width="13%"><EM><STRONG>CX_ERR_SRC_SHORTAGE</STRONG></EM></TD>
62<TD width="87%">Source data size is too small.</TD>
63    </TR>
64    <TR>
65<TD width="13%"><EM><STRONG>CX_ERR_SRC_REMAINDER</STRONG></EM></TD>
66<TD width="87%">Source data size is too large.</TD>
67    </TR>
68    <TR>
69<TD width="13%"><EM><STRONG>CX_ERR_ILLEGAL_TABLE</STRONG></EM></TD>
70<TD width="87%">The Huffman table contains mistakes.</TD>
71    </TR>
72  </TBODY>
73</TABLE>
74
75<H2>Description</H2>
76<P>Performs streaming uncompression of LRC-compressed data, doing just the data size given, and copies it to the buffer specified by the <A href="CXInitUncompContextLRC.html"><CODE>CXInitUncompContextLRC</CODE></A> function. Compared to the <A href="CXUncompressLRC.html"><CODE>CXUncompressLRC</CODE></A> function, which decompresses all data at once, this function is slow.</P>
77
78<h2>See Also</h2>
79<p><CODE>
80<A href="CXGetUncompressedSize.html">CXGetUncompressedSize</A>,
81<A href="CXUncompressLRC.html">CXUncompressLRC</A>,
82<A href="CXSecureUncompressLRC.html">CXSecureUncompressLRC</A>,
83<A href="CXInitUncompContextLRC.html">CXInitUncompContextLRC</A>,
84<A href="CXIsFinishedUncompLRC.html">CXIsFinishedUncompLRC</A>,
85<A href="../tools/ntcompress.html">ntrompress</A>
86</CODE></p>
87
88<H2>Revision History</H2>
89<P>2007/11/01 Initial version.</P>
90<hr><p>CONFIDENTIAL</p></body>
91</html>
92