FILE_REGION_INFO - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntifs.h
typedef struct _FILE_REGION_INFO {
LONGLONG FileOffset;
LONGLONG Length;
ULONG Usage;
ULONG Reserved;
} FILE_REGION_INFO, *PFILE_REGION_INFO;
View the official Windows Driver Kit DDI referenceNo description available.
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.
FileOffsetA 64-bit signed integer that contains the file offset, in bytes, of the region.
LengthA 64-bit signed integer that contains the size, in bytes, of the region.
UsageA 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. |
ReservedReserved; this field should be set to zero and ignored.