FILE_REGION_INFO structure (ntifs.h)
The FILE_REGION_INFO structure contains a computed region of a file based on a desired usage. This structure is used to store region information for the FSCTL_QUERY_FILE_REGIONS reply message, with the FILE_REGION_OUTPUT structure containing one or more FILE_REGION_INFO structures.
Syntax
typedef struct _FILE_REGION_INFO {
LONGLONG FileOffset;
LONGLONG Length;
ULONG Usage;
ULONG Reserved;
} FILE_REGION_INFO, *PFILE_REGION_INFO;
Members
FileOffset
A 64-bit signed integer that contains the file offset, in bytes, of the region.
Length
A 64-bit signed integer that contains the size, in bytes, of the region.
Usage
A 32-bit unsigned integer that indicates the usage for the given region of the file. Usage can be one of the following values.
| Value | Meaning |
|---|---|
| 0x00000000 | The given range is invalid. It does not match the criteria of the requested DesiredUsage. |
| FILE_USAGE_VALID_CACHED_DATA (0x00000001) | Defines those regions of the file that exists before VDL as it exists in the cache manager. |
| FILE_USAGE_VALID_NONCACHED_DATA (0x00000002) | Defines those regions of the files that exist before VDL on the storage device. |
Reserved
Reserved; this field should be set to zero and ignored.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 |
| Header | ntifs.h |