Edit

CSV_QUERY_FILE_REVISION_ECP_CONTEXT structure (ntifs.h)

  • Article

The CSV_QUERY_FILE_REVISION_ECP_CONTEXT structure contains the extra create parameter (ECP) context that can be sent to the Cluster Share Volumes (CSV) file system to request a file revision number.

Syntax

typedef struct _CSV_QUERY_FILE_REVISION_ECP_CONTEXT {
  LONGLONG FileId;
  LONGLONG FileRevision[3];
} CSV_QUERY_FILE_REVISION_ECP_CONTEXT, *PCSV_QUERY_FILE_REVISION_ECP_CONTEXT;

Members

FileId

The NTFS file ID.

FileRevision[3]

A LONGLONG value with file revision details:

  • FileRevision[0] increases each time the CSV MDS stack is rebuilt and CSVFLT loses its state.
  • FileRevision[1] increases each time the CSV MDS stack purges the cached revision number for the file.
  • FileRevision[2] increases each time CSV MDS observes that file sizes might have changed or the file might have been written to. It also is incremented when one of the nodes performs the first direct IO on a stream associated with this file after opening this stream.

If any of the numbers are 0 the caller should assume that the file was modified

Remarks

The file revision number is tracked by the Metadata Node.

The system-defined GUID_ECP_CSV_QUERY_FILE_REVISION value is used with this ECP context structure when calling ECP-related support routines such as FltAllocateExtraCreateParameter and FsRtlRemoveExtraCreateParameter.

See Introduction to extra create parameters for more information.

Requirements

Requirement Value
Minimum supported client Windows 8
Header ntifs.h