Share via

структура CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT (ntifs.h)

  • Статья

Структура CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT содержит дополнительный контекст параметра создания (ECP), который можно отправить в файловую систему общих томов кластера (CSV), чтобы задать свойства для обработки операций ввода-вывода, поступающих при открытии.

Синтаксис

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

Члены

Size

Размер этой структуры в байтах.

PauseTimeoutInSeconds

Количество секунд, в течение которых CSVFS может хранить операции ввода-вывода для этого объекта файла в состоянии ожидания в случае приостановки тома CSV. По истечении времени CSV завершит все операции ввода-вывода, выданные для этого объекта файла, с состоянием STATUS_CSV_IO_PAUSE_TIMEOUT. Этот элемент может быть одним из следующих значений.

Значение Значение
0xFFFFFFFF Указывает, что время ожидания отсутствует, и запрашивается поведение по умолчанию.
0 CSV не приостанавливает операции ввода-вывода и немедленно завершает операции ввода-вывода.
Любое другое значение CSV округляет все остальные значения до кратных 10 секунд и использует это значение в качестве времени ожидания. Максимальное поддерживаемое значение времени ожидания — 30 минут. Если указанное значение превышает 30 минут, CSV автоматически устанавливает максимальное значение.

Flags

Флаги свойств set. Этот элемент может быть битовой или из следующих флагов.

Flag Значение
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR Сообщает CSVFS, что открытый файл должен быть действителен только на координируемом узле. Если открытие выполняется в CSVFS, а узел не является координирующим узлом, открытие завершится ошибкой. Если файл открыт и координирующий узел перемещен, открытие файла будет недействительным. Этот флаг используется, только если файл открыт непосредственно в CSVFS, и игнорируется при открытии файла по протоколу SMB.

Более низкие 16 бит флагов предназначены для флагов, что приведет к сбою создания с STATUS_INVALID_PARAMETER если CSV не распознает их. Верхние 16 бит предназначены для флагов, которые будут игнорироваться автоматически, если CSVFS не знает, как их обрабатывать.

Комментарии

Системное значение GUID_ECP_CSV_SET_HANDLE_PROPERTIES используется с этой структурой контекста ECP при вызове связанных с ECP процедур поддержки, таких как FltAllocateExtraCreateParameter и FsRtlRemoveExtraCreateParameter.

Дополнительные сведения см. в статье Общие сведения о дополнительных параметрах создания .

Требования

Требование Значение
Минимальная версия клиента Windows 8
Верхняя часть ntifs.h