MFT_ENUM_DATA_V1 - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ntifs.h

typedef struct {
  ULONGLONG StartFileReferenceNumber;
  USN       LowUsn;
  USN       HighUsn;
  USHORT    MinMajorVersion;
  USHORT    MaxMajorVersion;
} MFT_ENUM_DATA_V1, *PMFT_ENUM_DATA_V1;
View the official Windows Driver Kit DDI reference
// winioctl.h

typedef struct {
  DWORDLONG StartFileReferenceNumber;
  USN       LowUsn;
  USN       HighUsn;
  WORD      MinMajorVersion;
  WORD      MaxMajorVersion;
} MFT_ENUM_DATA_V1, *PMFT_ENUM_DATA_V1;
View the official Win32 API reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ns-ntifs-mft_enum_data_v1)

Description

The MFT_ENUM_DATA_V1 structure 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.

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.

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

The minimum supported major version for the USN change journal.

MaxMajorVersion

The maximum supported major version for the USN change journal.

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

See also

FSCTL_ENUM_USN_DATA


Win32 API reference (ns-winioctl-mft_enum_data_v1)

MFT_ENUM_DATA_V1 structure

Description

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.

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.

See also

FSCTL_ENUM_USN_DATA

Volume Management Structures