FILE_ALLOCATED_RANGE_BUFFER

The FILE_ALLOCATED_RANGE_BUFFER structure is used with the FSCTL_QUERY_ALLOCATED_RANGES control code to indicate a range of bytes in a file. On input to the FSCTL_QUERY_ALLOCATED_RANGES control code, the structure indicates the range of the file to search. On output, the operation returns an array of FILE_ALLOCATED_RANGE_BUFFER structures to indicate the allocated ranges within the search range.

typedef struct _FILE_ALLOCATED_RANGE_BUFFER {
  LARGE_INTEGER FileOffset;
  LARGE_INTEGER Length;
} FILE_ALLOCATED_RANGE_BUFFER, *PFILE_ALLOCATED_RANGE_BUFFER;

Members

FileOffset

Indicates the file offset, in bytes, of the start of a range of bytes in a file.

Length

Indicates the size, in bytes, of the range.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Winioctl.h.

See Also

Device Input and Output Overview, Device Input and Output Structures, FSCTL_QUERY_ALLOCATED_RANGES, Sparse Files