RtlDecompressFragment 函数 (ntifs.h)

项目
10/04/2023

RtlDecompressFragment 函数用于解压缩压缩缓冲区的一部分 (即缓冲区“片段”) 。

语法

NT_RTL_COMPRESS_API NTSTATUS RtlDecompressFragment(
  [in]  USHORT CompressionFormat,
  [out] PUCHAR UncompressedFragment,
  [in]  ULONG  UncompressedFragmentSize,
  [in]  PUCHAR CompressedBuffer,
  [in]  ULONG  CompressedBufferSize,
  [in]  ULONG  FragmentOffset,
  [out] PULONG FinalUncompressedSize,
  [in]  PVOID  WorkSpace
);

参数

[in] CompressionFormat

指定压缩缓冲区的压缩格式的位掩码。此参数必须设置为 COMPRESSION_FORMAT_LZNT1。此和其他相关压缩格式值的含义如下：

值	含义
COMPRESSION_FORMAT_NONE	此函数不支持。
COMPRESSION_FORMAT_DEFAULT	此函数不支持。
COMPRESSION_FORMAT_LZNT1	指定应执行压缩。此值是必需的。

[out] UncompressedFragment

指向调用方分配的缓冲区的指针， (从分页池或非分页池分配，) 从 CompressedBuffer 接收解压缩的数据。此参数是必需的，不能为 NULL。

[in] UncompressedFragmentSize

UncompressedFragment 缓冲区的大小（以字节为单位）。

[in] CompressedBuffer

指向包含要解压缩的数据的缓冲区的指针。此参数是必需的，不能为 NULL。

[in] CompressedBufferSize

CompressedBuffer 缓冲区的大小（以字节为单位）。

[in] FragmentOffset

从零开始的偏移量（以字节为单位），从中提取未压缩的片段。此偏移值是原始未压缩缓冲区内的位置。

[out] FinalUncompressedSize

指向调用方分配的变量的指针，该变量接收 UncompressedFragment 中存储的解压缩数据的大小（以字节为单位）。此参数是必需的，不能为 NULL。

[in] WorkSpace

指向 RtlDecompressFragment 函数在解压缩期间使用的调用方分配的工作区缓冲区的指针。使用 RtlGetCompressionWorkSpaceSize 函数确定正确的工作区缓冲区大小。

返回值

RtlDecompressFragment返回相应的 NTSTATUS 代码，例如以下代码之一：

返回代码	说明
STATUS_SUCCESS	CompressedBuffer 缓冲区已成功解压缩到 UncompressedFragment 中。
STATUS_INVALID_PARAMETER	通过 CompressionFormat 参数指定了无效的压缩格式。如果 CompressionFormat 是COMPRESSION_FORMAT_NONE或COMPRESSION_FORMAT_DEFAULT (但不是同时) ，则返回此值。
STATUS_UNSUPPORTED_COMPRESSION	通过 CompressionFormat 参数指定了无效的压缩格式。如果 CompressionFormat 不是以下选项之一，则返回STATUS_UNSUPPORTED_COMPRESSION：COMPRESSION_FORMAT_LZNT1
STATUS_BAD_COMPRESSION_BUFFER	UncompressedFragment 不够大，无法包含未压缩的数据。

注解

相对于 RtlDecompressBuffer 函数， RtlDecompressFragment 用于从压缩缓冲区 (解压缩部分数据，而不是整个缓冲区) 。

若要确定 WorkSpace 参数的正确缓冲区大小，请使用 RtlGetCompressionWorkSpaceSize 函数 (即 RtlGetCompressionWorkSpaceSize 参数返回的值) 。

若要压缩未压缩的缓冲区，请使用 RtlCompressBuffer 函数。

若要解压缩整个压缩缓冲区，请使用 RtlDecompressBuffer 函数。

要求

要求	值
最低受支持的客户端	Windows XP
目标平台	通用
标头	ntifs.h (包括 Fltkernel.h、Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL