Функция FltRequestFileInfoOnCreateCompletion (fltkernel.h)

Статья
08/07/2023

Мини-фильтр вызывает FltRequestFileInfoOnCreateCompletion во время предварительного создания файла, чтобы запросить, чтобы диспетчер файлов хранил сведения о файле для извлечения во время после создания.

Синтаксис

NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
  PFLT_FILTER        Filter,
  PFLT_CALLBACK_DATA Data,
  ULONG              InfoClassFlags
);

Параметры

Filter

Указатель непрозрачного фильтра, который однозначно идентифицирует драйвер минифильтра.

Data

Указатель на FLT_CALLBACK_DATA данные обратного вызова, представляющие операцию создания ввода-вывода.

InfoClassFlags

Битовая маска флага, указывающая тип сведений о файлах, которые файловая система должна хранить для извлечения во время после создания. Может быть любым сочетанием следующих флагов:

Flag	Значение
QoCFileStatInformation (0x00000001)	Если этот параметр задан, файловая система будет хранить сведения о статистике файла в QUERY_ON_CREATE_FILE_STAT_INFORMATION структуре для извлечения.
QoCFileLxInformation (0x00000002)	Если этот параметр задан, файловая система будет хранить расширенные данные, подобные Linux, в QUERY_ON_CREATE_FILE_LX_INFORMATION структуре для извлечения.
QoCFileEaInformation (0x00000004)	Если этот параметр задан, файловая система будет хранить расширенные атрибуты (EA) в QUERY_ON_CREATE_EA_INFORMATION структуре для извлечения.

Возвращаемое значение

FltRequestFileInfoOnCreateCompletion может возвращать одно из следующих значений:

Код возврата	Описание
STATUS_SUCCESS	В файловой системе успешно сохранены запрошенные сведения о файле.
STATUS_INSUFFICIENT_RESOURCES	FltRequestFileInfoOnCreateCompletion не удалось выделить достаточный объем памяти для хранения запрошенных сведений о файле.
STATUS_INVALID_PARAMETER_2	Предоставленный объект данных обратного вызова не был операцией создания на основе IRP.

Мини-фильтр может получать сведения о файле, вызывая Метод FltRetrieveFileInfoOnCreateCompletionEx или FltRetrieveFileInfoOnCreateCompletion во время после создания. Производительность минифильтра обычно выше, когда он запрашивает и извлекает сведения о файле таким образом, а не запрашивает сведения о файле позже.