Edit

MFT_ENUM_DATA_V1 structure (winioctl.h)

  • Article

Contains information defining the boundaries for and starting place of an enumeration of update sequence number (USN) change journal records for ReFS volumes. It is used as the input buffer for the FSCTL_ENUM_USN_DATA control code.

Syntax

typedef struct {
  DWORDLONG StartFileReferenceNumber;
  USN       LowUsn;
  USN       HighUsn;
  WORD      MinMajorVersion;
  WORD      MaxMajorVersion;
} MFT_ENUM_DATA_V1, *PMFT_ENUM_DATA_V1;

Members

StartFileReferenceNumber

The ordinal position within the files on the current volume at which the enumeration is to begin.

The first call to FSCTL_ENUM_USN_DATA during an enumeration must have the StartFileReferenceNumber member set to (DWORDLONG)0. Each call to FSCTL_ENUM_USN_DATA retrieves the starting point for the subsequent call as the first entry in the output buffer. Subsequent calls must be made with StartFileReferenceNumber set to this value. For more information, see FSCTL_ENUM_USN_DATA.

LowUsn

The lower boundary of the range of USN values used to filter which records are returned. Only records whose last change journal USN is between or equal to the LowUsn and HighUsn member values are returned.

HighUsn

The upper boundary of the range of USN values used to filter which files are returned.

MinMajorVersion

Indicates the minimum supported major version for the USN change journal.

MaxMajorVersion

Indicates the maximum supported major version for the USN change journal.

Value Meaning
2
 The data returned from the FSCTL_ENUM_USN_DATA control code will contain USN_RECORD_V2 structures.
3
 The data returned from the FSCTL_ENUM_USN_DATA control code will contain USN_RECORD_V2 or USN_RECORD_V3 structures.

Requirements

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

See also

FSCTL_ENUM_USN_DATA

Volume Management Structures