# MI_SecureUncompressHuffman

## 構文

  `#include <nitro/mi.h>`
  `s32 MI_SecureUncompressHuffman( const void *srcp, u32 srcSize, void *destp, u32 dstSize );`

## 引数

srcp | ハフマン圧縮データの格納されているソースアドレス
srcSize | ソースデータサイズ
destp | 展開するディスティネーションアドレス
dstSize | 展開するディスティネーションサイズ

## 返り値

MI_ERR_SUCCESS | 正常終了
MIRR_UNSUPPORTED | 対応していない圧縮データタイプ
MI_ERR_SRC_SHORTAGE | ソースデータサイズが過小
MI_ERR_SRC_REMAINDER | ソースデータサイズが過大
MI_ERR_ILLEGAL_TABLE | ハフマンテーブルに誤りがある

## 説明

ハフマン圧縮データを展開し、指定のメモリ領域に32bit単位で書き込みます。
ソースアドレスは4byte 境界に合わせてください。

データのストリーミング展開をおこなう場合には、`MI_ReadUncompHuffman()`を利用します。

展開先のバッファサイズを確保する際の参考として、`MI_GetUncompressedSize()`を呼ぶことで、
圧縮データのヘッダに書かれている展開後のデータサイズを取得することができます。
圧縮データのヘッダが壊れており、正しい値が取得できなかった場合でも、各`SecureUncompress*()`の中で検知しエラーを返します。

## 参照

`MI_GetUncompressedSize, MI_UncompressHuffman, MI_InitUncompContextHuffman, MI_ReadUncompHuffman, MI_CompressHuffman, ntrcomp`

## 履歴

2008/05/22 初版