RtlDecompressFragment 함수(ntifs.h)

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 설정해야 합니다. 이 값 및 기타 관련 압축 형식 값의 의미는 다음과 같습니다.

[out] UncompressedFragment

CompressedBuffer에서 압축 해제된 데이터를 수신하는 호출자 할당 버퍼(페이징된 풀 또는 페이징되지 않은 풀에서 할당됨)에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[in] UncompressedFragmentSize

UncompressedFragment 버퍼의 크기(바이트)입니다.

[in] CompressedBuffer

압축을 풀 데이터를 포함하는 버퍼에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[in] CompressedBufferSize

CompressedBuffer 버퍼의 크기(바이트)입니다.

[in] FragmentOffset

압축되지 않은 조각이 추출되는 0부터 시작하는 오프셋(바이트)입니다. 이 오프셋 값은 원래 압축되지 않은 버퍼 내의 위치입니다.

[out] FinalUncompressedSize

UncompressedFragment에 저장된 압축 해제된 데이터의 크기(바이트)를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[in] WorkSpace

압축을 풀 때 RtlDecompressFragment 함수에서 사용하는 호출자가 할당한 작업 공간 버퍼에 대한 포인터입니다. RtlGetCompressionWorkSpaceSize 함수를 사용하여 올바른 작업 공간 버퍼 크기를 확인합니다.

반환 값

RtlDecompressFragment는 다음 중 하나와 같은 적절한 NTSTATUS 코드를 반환합니다.

설명

RtlDecompressBuffer 함수를 기준으로 RtlDecompressFragment는 압축된 버퍼에서 데이터의 일부를 압축 해제하는 데 사용됩니다(전체 버퍼와 반대).

WorkSpace 매개 변수에 대한 올바른 버퍼 크기를 확인하려면 RtlGetCompressionWorkSpaceSize 함수(즉, RtlGetCompressionWorkSpaceSize 매개 변수에서 반환된 값)를 사용합니다.

압축되지 않은 버퍼를 압축하려면 RtlCompressBuffer 함수를 사용합니다.

압축된 전체 버퍼의 압축을 풀려면 RtlDecompressBuffer 함수를 사용합니다.

요구 사항

추가 정보

FILE_COMPRESSION_INFORMATION

RtlCompressBuffer

RtlDecompressBuffer

RtlDecompressBufferEx

RtlDecompressBufferEx2

RtlDecompressFragmentEx