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

Статья
02/06/2025

Подпрограмма fltGetFilterInformation предоставляет сведения о драйвере мини-фильтра.

Синтаксис

NTSTATUS FLTAPI FltGetFilterInformation(
  [in]  PFLT_FILTER              Filter,
  [in]  FILTER_INFORMATION_CLASS InformationClass,
  [out] PVOID                    Buffer,
  [in]  ULONG                    BufferSize,
  [out] PULONG                   BytesReturned
);

Параметры

[in] Filter

Непрозрачный указатель фильтра для вызывающего объекта.

[in] InformationClass

Тип запрошенной информации. Этот параметр может иметь одно из следующих значений.

Ценность	Значение
FilterFullInformation	Буфер, на который указывает параметр буфера, получает структуру FILTER_FULL_INFORMATION для драйвера мини-фильтра.
FilterAggregateBasicInformation	Буфер, на который указывает параметр буфера буфера, получает структуру FILTER_AGGREGATE_BASIC_INFORMATION для драйвера мини-фильтра. Это значение InformationClass доступно начиная с microsoft Windows Server 2003 с пакетом обновления 1 (SP1) и Windows XP с пакетом обновления 2 (SP2) с накопительным пакетом обновления 2 (SP2) диспетчера фильтров. Дополнительные сведения о пакете свертки диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) см. в статье 914882 " пакет накопительного пакета диспетчера фильтров для Windows XP с пакетом обновления 2(SP2) " в Базе знаний Майкрософт.
FilterAggregateStandardInformation	Буфер, на который указывает параметр буфера, получает структуру FILTER_AGGREGATE_STANDARD_INFORMATION для драйвера минифильтра. устаревшей части структуры не используется. Это значение InformationClass доступно начиная с Windows Vista.

[out] Buffer

Указатель на выделенный вызывающим буфером, который получает запрошенные сведения. Тип информации, возвращаемой в буфере, определяется параметром InformationClass.

[in] BufferSize

Размер буфера в байтах, на который указывает параметр буфера. Вызывающий объект должен задать этот параметр в соответствии с заданным значением InformationClass.

[out] BytesReturned

Указатель на выделенную вызывающим переменную, которая получает количество байтов, возвращаемых в буфере, на который буфер указывает. Если входное значение BufferSize слишком мало, FltGetFilterInformation возвращает STATUS_BUFFER_TOO_SMALL и задает для этой переменной количество байтов, необходимых для хранения запрошенных сведений. Этот параметр является обязательным и не может быть null.

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

FltGetFilterInformation возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих:

Возвращаемый код	Описание
STATUS_BUFFER_TOO_SMALL	Буфер, на который указывает параметр буфера, недостаточно велик для хранения запрошенных сведений. Это код ошибки.
STATUS_INVALID_PARAMETER	Недопустимое значение было указано для параметра InformationClass. Например, если FilterAggregateStandardInformation указан в операционной системе до Windows Vista, подпрограмма возвращает STATUS_INVALID_PARAMETER. Это код ошибки.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	fltkernel.h (include FltKernel.h)
библиотеки	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL