CreateCompressor 関数 (compressapi.h)

  • [アーティクル]

新しい COMPRESSOR_HANDLEを生成します。

構文

BOOL CreateCompressor(
  [in]           DWORD                         Algorithm,
  [in, optional] PCOMPRESS_ALLOCATION_ROUTINES AllocationRoutines,
  [out]          PCOMPRESSOR_HANDLE            CompressorHandle
);

パラメーター

[in] Algorithm

この圧縮機によって使用される圧縮アルゴリズムおよびモードのタイプ。

このパラメーターには、必要に応じて、次のいずれかの値を COMPRESS_RAW フラグと組み合わせることができます。 "ビットごとの OR" 演算子を使用して 、COMPRESS_RAW を含め、ブロック モードコンプレッサーを作成します。 COMPRESS_RAWが含まれていない場合、Compression API はバッファー モードのコンプレッサーを作成します。 圧縮アルゴリズムとモードの選択の詳細については、「 圧縮 API の使用」を参照してください。

値 意味
COMPRESS_ALGORITHM_MSZIP
2
 MSZIP 圧縮アルゴリズム
COMPRESS_ALGORITHM_XPRESS
3
 XPRESS 圧縮アルゴリズム
COMPRESS_ALGORITHM_XPRESS_HUFF
4
 Huffman エンコードを使用した XPRESS 圧縮アルゴリズム
COMPRESS_ALGORITHM_LZMS
5
 LZMS 圧縮アルゴリズム

[in, optional] AllocationRoutines

COMPRESS_ALLOCATION_ROUTINES構造体内の省略可能なメモリ割り当ておよび割り当て解除ルーチン。

[out] CompressorHandle

関数が成功した場合は、指定された圧縮機へのハンドル。

戻り値

関数が成功すると、戻り値は 0 以外になります。 関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

何らかの内部的な理由で圧縮アルゴリズムが失敗した場合、 GetLastError からの エラーが ERROR_FUNCTION_FAILEDされる可能性があります。 指定した名前とバージョンに一致する圧縮アルゴリズムがシステムで見つからない場合は、エラーを ERROR_NOT_SUPPORTEDできます。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー compressapi.h
Library Cabinet.lib
[DLL] Cabinet.dll

こちらもご覧ください

COMPRESS_ALLOCATION_ROUTINES

圧縮 API 関数