FILE_LEVEL_TRIM_RANGE structure (winioctl.h)

Specifies a range of a file that is to be trimmed.

Syntax

typedef struct _FILE_LEVEL_TRIM_RANGE {
  DWORDLONG Offset;
  DWORDLONG Length;
} FILE_LEVEL_TRIM_RANGE, *PFILE_LEVEL_TRIM_RANGE;

Members

Offset

Offset, in bytes, from the start of the file for the range to be trimmed.

Length

Length, in bytes, for the range to be trimmed.

Remarks

Before the trim operation is passed to the underlying storage system the input ranges are reduced to be aligned to page boundaries (4,096 bytes on 32-bit and x64-based editions of Windows, 8,192 bytes on Itanium-Based editions of Windows).

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header winioctl.h (include Windows.h)

See also

FILE_LEVEL_TRIM

FILE_LEVEL_TRIM_OUTPUT

FSCTL_FILE_LEVEL_TRIM