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

Статья
08/07/2023

Подпрограмма FltSupportsFileContextsEx определяет, поддерживает ли файловая система или диспетчер фильтров контексты файлов для данного файла.

Синтаксис

BOOLEAN FLTAPI FltSupportsFileContextsEx(
  [in]           PFILE_OBJECT  FileObject,
  [in, optional] PFLT_INSTANCE Instance
);

Параметры

[in] FileObject

Указатель на объект file, представляющий файл, для которого запрашивается поддержка контекста файла. Этот параметр является обязательным и не может иметь значение NULL.

[in, optional] Instance

Указатель непрозрачного экземпляра для вызывающего объекта. Этот параметр является необязательным и может иметь значение NULL. Дополнительные сведения об этом параметре см. в разделе Примечания этой страницы.

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

FltSupportsFileContextsEx возвращает значение TRUE , если файловая система или диспетчер фильтров поддерживает контексты файлов для файла; Значение FALSE в противном случае.

Драйверы минифильтра могут вызывать подпрограмму FltSupportsFileContextsEx , чтобы определить, поддерживает ли базовая файловая система или диспетчер фильтров контексты файлов для файла, представленного FileObject , без необходимости выделять контекст и пытаться задать его. Если тип контекста не поддерживается в файле, минифильтр не может прикрепить контекст к этому файлу.

Для файловых систем (например, FAT), поддерживающих только один поток данных для каждого файла, контексты файлов эквивалентны контекстам потоков. Такие файловые системы обычно поддерживают контексты потоков, но не поддерживают контексты файлов. Вместо этого диспетчер фильтров обеспечивает поддержку контекста файлов, используя существующую поддержку контекстов потока в файловой системе. Для экземпляров минифильтра, присоединенных к этим файловым системам, Функция FltSupportsFileContexts возвращает значение FALSE, а FltSupportsFileContextsEx возвращает значение TRUE (если для параметра Instance передается допустимое значение, отличное от NULL).

Если для параметра Instance указано значение, отличное от NULL, функция FltSupportsFileContextsEx возвращает значение TRUE, если файловая система или диспетчер фильтров поддерживает контексты файлов для файла; Значение FALSE в противном случае.

Если параметр Instance имеет значение NULL, FltSupportsFileContextsEx возвращает значение TRUE , только если файловая система поддерживает контексты файлов для файла. В противном случае возвращается значение FALSE, даже если диспетчер фильтров поддерживает контексты файлов для файла.

Обратите внимание, что файловая система может поддерживать контексты файлов для некоторых типов файлов, но не для других. Например, NTFS и FAT не поддерживают контексты файлов подкачки.

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

Требования

Требование	Значение
Минимальная версия клиента	Эта подпрограмма доступна в Windows Vista и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL