Edit

CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128 structure (ntifs.h)

  • Article

The CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128 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_FILE_ID_128 {
  FILE_ID_128 FileId;
  LONGLONG    FileRevision[3];
} CSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128, *PCSV_QUERY_FILE_REVISION_ECP_CONTEXT_FILE_ID_128;

Members

FileId

The 128-bit file ID.

FileRevision[3]

  • 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.

Remarks

The file revision number is tracked by the Metadata Node.

The system-defined GUID_ECP_CSV_QUERY_FILE_REVISION_FILE_ID_128 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