Compartir a través de


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.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

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.