Функция FltGetFilterInformation (fltkernel.h)
Подпрограмма 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 | Буфер, на который указывает параметр Buffer , получает структуру FILTER_FULL_INFORMATION для драйвера минифильтра. |
FilterAggregateBasicInformation | Буфер, на который указывает параметр Buffer , получает структуру FILTER_AGGREGATE_BASIC_INFORMATION для драйвера минифильтра. Это значение InformationClass доступно начиная с Microsoft Windows Server 2003 с пакетом обновления 1 (SP1) и Windows XP с пакетом обновления 2 (SP2) с накопительным пакетом обновления диспетчера фильтров. Дополнительные сведения о накопительном пакете диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) см. в статье 914882 " Накопительный пакет диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) в базе знаний Майкрософт. |
FilterAggregateStandardInformation | Буфер, на который указывает параметр Buffer , получает структуру FILTER_AGGREGATE_STANDARD_INFORMATION для драйвера минифильтра. Часть legacyFilter структуры не используется. Это значение InformationClass доступно начиная с Windows Vista. |
[out] Buffer
Указатель на буфер, выделенный вызывающим объектом, который получает запрошенные сведения. Тип сведений, возвращаемых в буфере, определяется параметром InformationClass .
[in] BufferSize
Размер (в байтах) буфера, на который указывает параметр Buffer . Вызывающий объект должен задать этот параметр в соответствии с заданным значением InformationClass .
[out] BytesReturned
Указатель на переменную, выделенную вызывающим объектом, которая получает количество байтов, возвращаемых в буфере, на который указывает buffer . Если входное значение BufferSize слишком мало, FltGetFilterInformation возвращает STATUS_BUFFER_TOO_SMALL и задает для этой переменной количество байтов, необходимых для хранения запрошенной информации. Этот параметр является обязательным и не может иметь значение NULL.
Возвращаемое значение
FltGetFilterInformation возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений:
Код возврата | Описание |
---|---|
|
Буфер, на который указывает параметр Buffer , недостаточно велик для хранения запрошенной информации. Это код ошибки. |
|
Для параметра InformationClass указано недопустимое значение. Например, если параметр FilterAggregateStandardInformation указан в операционной системе, предшествующей Windows Vista, подпрограмма возвращает STATUS_INVALID_PARAMETER. Это код ошибки. |
Требования
Требование | Значение |
---|---|
Целевая платформа | Универсальное |
Верхняя часть | fltkernel.h (включая FltKernel.h) |
Библиотека | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |
См. также раздел
FILTER_AGGREGATE_BASIC_INFORMATION
FILTER_AGGREGATE_STANDARD_INFORMATION
FltEnumerateInstanceInformationByFilter