FILE_REGION_INFO 結構 (ntifs.h)

發行項
02/26/2024

FILE_REGION_INFO 結構會根據所需的使用量，包含檔案的計算區域。這個結構可用來儲存 FSCTL_QUERY_FILE_REGIONS 回復訊息的區域資訊，而 FILE_REGION_OUTPUT 結構包含一或多個 FILE_REGION_INFO 結構。

語法

typedef struct _FILE_REGION_INFO {
  LONGLONG FileOffset;
  LONGLONG Length;
  ULONG    Usage;
  ULONG    Reserved;
} FILE_REGION_INFO, *PFILE_REGION_INFO;

成員

FileOffset

包含區域之檔案位移的64位帶正負號整數，以位元組為單位。

Length

64 位帶正負號的整數，其中包含區域的大小，以位元組為單位。

Usage

指出檔案指定區域使用量的32位無符號整數。使用方式可以是下列其中一個值。

值	意義
0x00000000	指定的範圍無效。它不符合要求的 DesiredUsage 準則。
FILE_USAGE_VALID_CACHED_DATA (0x00000001)	定義存在於 VDL 之前之檔案的區域，因為它存在於快取管理員中。
FILE_USAGE_VALID_NONCACHED_DATA (0x00000002)	定義儲存裝置上 VDL 之前存在的檔案區域。