FILE_REGION_INPUT結構 (ntifs.h)
FILE_REGION_INPUT 是 FSCTL_QUERY_FILE_REGIONS的選擇性輸入結構。
語法
typedef struct _FILE_REGION_INPUT {
LONGLONG FileOffset;
LONGLONG Length;
ULONG DesiredUsage;
} FILE_REGION_INPUT, *PFILE_REGION_INPUT;
成員
FileOffset
64 位帶正負號的整數，其中包含檔案中位元組範圍開頭的檔案位移，以位元組為單位。
Length
64 位帶正負號的整數，其中包含範圍的大小，以位元組為單位。
DesiredUsage
32 位無符號整數，表示此作業的使用參數。 DesiredUsage 可以是下列其中一個值。
| 值 | 意義 |
|---|---|
| FILE_REGION_USAGE_VALID_CACHED_DATA (0x00000001) | 要求傳回快取中指定檔案和檔案範圍之有效數據長度的資訊 (VDL) 。 |
| FILE_REGION_USAGE_VALID_NONCACHED_DATA (0x00000002) | 要求傳回磁碟上指定檔案和檔案範圍之 VDL 的相關信息。 |
| 所有其他的值 | 如果在FSCTL_QUERY_FILE_REGION中指定FILE_REGION_INPUT物件，則任何其他值都會傳回STATUS_INVALID_PARAMETER。 |
備註
如需詳細資訊 ，請參閱FSCTL_QUERY_FILE_REGIONS 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 標頭 | ntifs.h |