RtlDecompressBufferEx2 関数 (ntifs.h)

[アーティクル]
02/29/2024

RtlDecompressBufferEx2 関数は、可能な限り複数のプロセッサを使用して、圧縮されたバッファー全体を圧縮解除します。複数のプロセッサのサポートは、カーネルモードの呼び出し元に対してのみ実装されます。

構文

NT_RTL_COMPRESS_API NTSTATUS RtlDecompressBufferEx2(
  [in]           USHORT CompressionFormat,
  [out]          PUCHAR UncompressedBuffer,
  [in]           ULONG  UncompressedBufferSize,
  [in]           PUCHAR CompressedBuffer,
  [in]           ULONG  CompressedBufferSize,
  [in]           ULONG  UncompressedChunkSize,
  [out]          PULONG FinalUncompressedSize,
  [in, optional] PVOID  WorkSpace
);

パラメーター

[in] CompressionFormat

圧縮バッファーの圧縮形式を指定するビットマスク。このパラメーターは、COMPRESSION_FORMAT_LZNT1に設定する必要があります。このおよび他の関連する圧縮形式の値の意味は次のとおりです。

値	意味
COMPRESSION_FORMAT_NONE	この関数ではサポートされていません。
COMPRESSION_FORMAT_DEFAULT	この関数ではサポートされていません。
COMPRESSION_FORMAT_LZNT1	関数は LZ 圧縮を実行します。
COMPRESSION_FORMAT_XPRESS	関数は Xpress 圧縮を実行します。
COMPRESSION_FORMAT_XPRESS_HUFF	関数は Xpress Huffman 圧縮解除を実行します。

[out] UncompressedBuffer

CompressedBuffer から圧縮解除されたデータを受け取る呼び出し元によって割り当てられたバッファー (ページプールまたは非ページプールから割り当てられる) へのポインター。このパラメーターは必須であり、NULL にすることはできません。

[in] UncompressedBufferSize

非圧縮バッファー バッファーのサイズ (バイト単位)。

[in] CompressedBuffer

圧縮解除するデータを含むバッファーへのポインター。このパラメーターは必須であり、NULL にすることはできません。

[in] CompressedBufferSize

CompressedBuffer バッファーのサイズ (バイト単位)。

[in] UncompressedChunkSize

圧縮バッファー内の各チャンクのサイズ (バイト単位)。有効な値は、512、1024、2048、4096 です。

[out] FinalUncompressedSize

CompressedBuffer に格納されている圧縮解除されたデータのサイズ (バイト単位) を受け取る呼び出し元によって割り当てられた変数へのポインター。このパラメーターは必須であり、NULL にすることはできません。

[in, optional] WorkSpace

展開時に RtlDecompressBufferEx2 関数によって使用される呼び出し元によって割り当てられた作業領域バッファーへのポインター。 RtlGetCompressionWorkSpaceSize 関数を使用して、正しい作業スペースバッファーサイズを決定します。

戻り値

RtlDecompressBufferEx2 は、次のいずれかの適切なエラー状態値を返します。

リターンコード	説明
STATUS_SUCCESS	CompressedBuffer バッファーが正常に圧縮解除されました。
STATUS_INVALID_PARAMETER	CompressionFormat パラメーターを使用して、無効な圧縮形式が指定されました。 CompressionFormat がCOMPRESSION_FORMAT_NONEまたはCOMPRESSION_FORMAT_DEFAULT (両方ではない) の場合は、この値が返されます。
STATUS_UNSUPPORTED_COMPRESSION	CompressionFormat パラメーターを使用して、無効な圧縮形式が指定されました。 CompressionFormat が次のいずれかでない場合は、STATUS_UNSUPPORTED_COMPRESSIONが返されます:COMPRESSION_FORMAT_LZNT1、COMPRESSION_FORMAT_XPRESS、COMPRESSION_FORMAT_XPRESS_HUFF、COMPRESSION_FORMAT_NONE、COMPRESSION_FORMAT_DEFAULT
STATUS_BAD_COMPRESSION_BUFFER	非圧縮バッファーは、圧縮されていないデータを格納するのに十分な大きさではありません。

注釈

RtlDecompressBufferEx2 関数は、圧縮バッファー全体を入力として受け取り、圧縮されていないデータが指定されたコピー先バッファー内に収まる場合、圧縮解除された同等のデータを生成します。

圧縮バッファーの一部 (つまり、バッファーの "フラグメント") のみを圧縮解除するには、 RtlDecompressFragment 関数を使用します。

圧縮されていないバッファーを圧縮するには、 RtlCompressBuffer 関数を 使用します。

要件

要件	値
サポートされている最小のクライアント	Windows 10
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Fltkernel.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL