Функция FltRequestFileInfoOnCreateCompletion (fltkernel.h)
Минифильтр вызывает FltRequestFileInfoOnCreateComplet ion во время предварительного создания файла, чтобы запросить, чтобы файловая система хранит сведения о файле для получения во время создания.
Синтаксис
NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
ULONG InfoClassFlags
);
Параметры
Filter
Указатель непрозрачного фильтра, который однозначно идентифицирует драйвер минифильтра.
Data
Указатель на данные обратного вызова FLT_CALLBACK_DATA, представляющие операцию создания ввода-вывода.
InfoClassFlags
Пометка битовой маски, указывающая тип сведений о файле, которые файловая система должна хранить для извлечения во время создания после создания. Может быть любое сочетание следующих флагов:
| Флаг | Значение |
|---|---|
| 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 структуре для извлечения. |
| QoCFileUsnInformation (0x00000008) | Если задано, файловая система будет хранить сведения ОБ USN в QUERY_ON_CREATE_USN_INFORMATION структуре для получения. |
Возвращаемое значение
FltRequestFileInfoOnCreateCompletion может возвращать одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Файловая система успешно хранит запрошенные сведения о файле. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestFileInfoOnCreateCompletion не удалось выделить достаточно памяти для хранения запрошенных сведений о файле. |
| STATUS_INVALID_PARAMETER_2 | Предоставленный объект данных обратного вызова не был операцией создания на основе IRP. |
Замечания
Минифильтр может получить сведения о файле, вызвав FltRetrieveFileInfoOnCreateCompletionEx или FltRetrieveFileInfoOnCreateCompletion во время создания. Производительность минифильтра обычно лучше, если она запрашивает и извлекает сведения о файлах таким образом, а не запрашивает сведения о файлах позже.
Требования
| Требование | Ценность |
|---|---|
| заголовка | fltkernel.h (include Fltkernel.h) |