FILE_REGION_INPUT structure (ntifs.h)
FILE_REGION_INPUT is the optional input structure for FSCTL_QUERY_FILE_REGIONS.
Syntax
typedef struct _FILE_REGION_INPUT {
LONGLONG FileOffset;
LONGLONG Length;
ULONG DesiredUsage;
} FILE_REGION_INPUT, *PFILE_REGION_INPUT;
Members
FileOffset
A 64-bit signed integer that contains the file offset, in bytes, of the start of a range of bytes in a file.
Length
A 64-bit signed integer that contains the size, in bytes, of the range.
DesiredUsage
A 32-bit unsigned integer that indicates usage parameters for this operation. DesiredUsage can be one of the following values.
| Value | Meaning |
|---|---|
| FILE_REGION_USAGE_VALID_CACHED_DATA (0x00000001) | Requests that information about the valid data length (VDL) for the specified file and file range in the cache be returned. |
| FILE_REGION_USAGE_VALID_NONCACHED_DATA (0x00000002) | Requests that information about the VDL for the specified file and file range on disk be returned. |
| All other values | If a FILE_REGION_INPUT object is specified in FSCTL_QUERY_FILE_REGION, then any other value will return STATUS_INVALID_PARAMETER. |
Remarks
See FSCTL_QUERY_FILE_REGIONS for details.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 |
| Header | ntifs.h |