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>CXReadUncompHuffman</title>
9<LINK rel="stylesheet" href="../CSS/revolution.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">CXReadUncompHuffman</h1>
15
16<h2>Syntax</h2>
17<DL><DD><PRE class="construction">
18#include &lt;revolution/cx/CXStreamingUncompression.h&gt;
19
20s32 CXReadUncompHuffman( <A href="CXUncompContextHuffman.html">CXUncompContextHuffman</A> *context,
21                         const void*             data,
22                         u32                     len );
23</PRE></dd></dl>
24
25<h2>Arguments</h2>
26<TABLE class="arguments" border="1">
27  <TBODY>
28    <TR>
29<TH>context</TH>
30<TD>Pointer to the context structure for uncompression of Huffman compressed data.</TD>
31    </TR>
32    <TR>
33<TH>data</TH>
34<TD>Pointer to the next data in the file being decompressed.</TD>
35    </TR>
36    <TR>
37<TH>len</TH>
38<TD>Size of the data provided in the second argument.</TD>
39    </TR>
40  </TBODY>
41</TABLE>
42
43<h2>Return Values</h2>
44<p>Returns a positive value if data remains to be uncompressed, and a negative error code if an error has occurred.<BR>Returns 0 if all data was successfully decompressed.</p>
45<TABLE class="arguments" border="1">
46  <TBODY>
47    <TR>
48<TH>Positive integer</TH>
49<TD>Number of bytes not yet decompressed.</TD>
50    </TR>
51    <TR>
52<TH>CX_ERR_SUCCESS</TH>
53<TD>Ended normally (==0).</TD>
54    </TR>
55    <TR>
56<TH>CX_ERR_UNSUPPORTED</TH>
57<TD>Unsupported compression data type.</TD>
58    </TR>
59    <TR>
60<TH>CX_ERR_SRC_SHORTAGE</TH>
61<TD>Source data size is too small.</TD>
62    </TR>
63    <TR>
64<TH>CX_ERR_SRC_REMAINDER</TH>
65<TD>Source data size is too large.</TD>
66    </TR>
67    <TR>
68<TH>CX_ERR_ILLEGAL_TABLE</TH>
69<TD>The Huffman table contains mistakes.</TD>
70    </TR>
71  </TBODY>
72</TABLE>
73
74
75<H2>Description</H2>
76<P>Performs streaming uncompression of Huffman compressed data, processing just the data size given, and copies it to the buffer specified by the <A href="CXInitUncompContextHuffman.html"><CODE>CXInitUncompContextHuffman</CODE></A> function. This function is slower than the <A href="CXUncompressHuffman.html"><CODE>CXUncompressHuffman</CODE></A> function, which decompresses all data at once.</P>
77
78<h2>See Also</h2>
79<p class="reference">
80<A href="CXGetUncompressedSize.html">CXGetUncompressedSize</A>,
81<A href="CXUncompressHuffman.html">CXUncompressHuffman</A>,
82<A href="CXSecureUncompressHuffman.html">CXSecureUncompressHuffman</A>,
83<A href="CXInitUncompContextHuffman.html">CXInitUncompContextHuffman</A>,
84<A href="CXIsFinishedUncompHuffman.html">CXIsFinishedUncompHuffman</A>,
85<A href="CXCompressHuffman.html">CXCompressHuffman</A>,
86<A href="../tools/ntcompress.html">ntcompress</A>
87</p>
88
89<H2>Revision History</H2>
90<P>
912007/09/03 Corrected errors in <B>Description</B> and <B>See Also</B>.<BR>2006/07/06 Initial version.<BR>
92</P>
93
94<hr><p>CONFIDENTIAL</p></body>
95</html>
96