READ_USN_JOURNAL_DATA_V1 structure (ntifs.h)

The READ_USN_JOURNAL_DATA_V1 structure contains information defining a set of update sequence number (USN) change journal records to return to the calling process. It is used by the FSCTL_QUERY_USN_JOURNAL and FSCTL_READ_USN_JOURNAL control codes. Prior to Windows 8 and Windows Server 2012 this structure was named READ_USN_JOURNAL_DATA. Windows Server 2012 introduced READ_USN_JOURNAL_DATA_V1 to support 128-bit file identifiers used by ReFS.

Syntax

typedef struct {
 USN StartUsn;
 ULONG ReasonMask;
 ULONG ReturnOnlyOnClose;
 ULONGLONG Timeout;
 ULONGLONG BytesToWaitFor;
 ULONGLONG UsnJournalID;
 USHORT MinMajorVersion;
 USHORT MaxMajorVersion;
} READ_USN_JOURNAL_DATA_V1, *PREAD_USN_JOURNAL_DATA_V1;

Members

StartUsn

See READ_USN_JOURNAL_DATA_V0.StartUsn.

ReasonMask

See READ_USN_JOURNAL_DATA_V0.ReasonMask.

ReturnOnlyOnClose

See READ_USN_JOURNAL_DATA_V0.ReturnOnlyOnClose.

Timeout

See READ_USN_JOURNAL_DATA_V0.Timeout.

BytesToWaitFor

See READ_USN_JOURNAL_DATA_V0.BytesToWaitFor.

UsnJournalID

See READ_USN_JOURNAL_DATA_V0.UsnJournalID.

MinMajorVersion

The minimum major version of the USN record that the caller can accept. This allows the caller to ensure compatibility with the journal format.

MaxMajorVersion

The maximum major version of the USN record that the caller can accept. This ensures that the caller does not receive records in an unexpected format.

Requirements

See also

FSCTL_QUERY_USN_JOURNAL

FSCTL_READ_USN_JOURNAL