2.3.56.1 FILE_REGION_INFO
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.
A FILE_REGION_INFO data element is as follows.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
FileOffset |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
Length |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
DesiredUsage |
|||||||||||||||||||||||||||||||
|
Reserved |
|||||||||||||||||||||||||||||||
FileOffset (8 bytes): A 64-bit signed integer that contains the file offset, in bytes, of the region.
Length (8 bytes): A 64-bit signed integer that contains the size, in bytes, of the region.
DesiredUsage (4 bytes): A 32-bit unsigned integer that indicates the usage for the given region of the file.
-
Value
Meaning
0x00000000
The given range is invalid. It does not match the criteria of the requested DesiredUsage as specified in section 2.3.55.
FILE _USAGE_VALID_CACHED_DATA
0x00000001
Defines those regions of the file that exists before VDL as it exists in the cache manager.<49>
FILE _USAGE_VALID_NONCACHED_DATA
0x00000002
Defines those regions of the files that exist before VDL on the storage device.<50>
-
Reserved (4 bytes): A 32-bit unsigned integer field that is reserved. This field SHOULD be set to 0x00000000 and MUST be ignored.