(ntifs.h) RtlDecompressFragmentEx 函式

  • 發行項

RtlDecompressFragmentEx 函式可用來解壓縮壓縮緩衝區 (部分，也就是盡可能使用多個處理器的緩衝區「片段」) 。

語法

NT_RTL_COMPRESS_API NTSTATUS RtlDecompressFragmentEx(
  [in]  USHORT CompressionFormat,
  [out] PUCHAR UncompressedFragment,
  [in]  ULONG  UncompressedFragmentSize,
  [in]  PUCHAR CompressedBuffer,
  [in]  ULONG  CompressedBufferSize,
  [in]  ULONG  FragmentOffset,
  [in]  ULONG  UncompressedChunkSize,
  [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

以位元組為單位的以零起始的位移，其中正在擷取未壓縮的片段。 這個位移值是原始未壓縮緩衝區內的位置。

[in] UncompressedChunkSize

壓縮緩衝區內每個區塊的大小，以位元組為單位。 有效值為 512、1024、2048 和 4096。

[out] FinalUncompressedSize

呼叫端配置變數的指標，可接收 儲存在 UncompressedFragment 中解壓縮之數據的大小，以位元組為單位。 這個參數是必要的，而且不能是 NULL。

[in] WorkSpace

在解壓縮期間 ，RtlDecompressFragmentEx 函式所使用的呼叫端配置工作區緩衝區指標。 使用 RtlGetCompressionWorkSpaceSize 函式來判斷正確的工作區緩衝區大小。

傳回值

RtlDecompressFragmentEx 會傳回適當的 NTSTATUS 程式代碼，例如下列其中一項：

傳回碼 Description
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 不夠大，無法包含未壓縮的數據。

規格需求

需求 值
最低支援的用戶端 Windows 10
目標平台 Universal
標頭 ntifs.h (包含 Fltkernel.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

FILE_COMPRESSION_INFORMATION

RtlCompressBuffer

RtlDecompressBuffer

RtlDecompressBufferEx

RtlDecompressBufferEx2

RtlDecompressFragment