Поделиться через

структура 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. Этот элемент может быть битовой или из следующих флагов.

Флаг Значение
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