FILE_ALLOCATED_RANGE_BUFFER 結構 (ntifs.h)

  • 發行項

FILE_ALLOCATED_RANGE_BUFFER 結構會在 FSCTL_QUERY_ALLOCATED_RANGES 控制程式碼要求期間當做輸入和輸出使用。

語法

typedef struct _FILE_ALLOCATED_RANGE_BUFFER {
  LARGE_INTEGER FileOffset;
  LARGE_INTEGER Length;
} FILE_ALLOCATED_RANGE_BUFFER, *PFILE_ALLOCATED_RANGE_BUFFER;

成員

FileOffset

在 FSCTL 輸入上，包含檔案中位元組開頭位元組的檔案位移。 FileOffset 必須大於或等於 0。

在 FSCTL 輸出上，包含檔案開頭以位元組為單位的檔案位移;配置記憶體的位元組範圍開始。 如果檔案是疏鬆檔案， FileOffset 可以包含未配置記憶體的位元元組範圍;這些範圍將會從 FSCTL_QUERY_ALLOCATED_RANGES所傳回的已配置範圍清單中排除。 因為使用疏鬆檔案的應用程式可以選擇是否要配置每個0x00值位元組序列的磁碟空間，所以配置的範圍可以包含0x00值位元組。 此值必須在輸出時大於或等於 0。

Length

包含範圍位元組的大小。 在 FSCTL 輸入上， Length 必須大於或等於 0。 在 FSCTL 輸出上， 長度 必須大於 0。

規格需求

需求 值
最低支援的用戶端 Windows 2000
標頭 ntifs.h

另請參閱

FSCTL_QUERY_ALLOCATED_RANGES