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	Buffer 参数指向的缓冲区接收微型筛选器驱动程序的 FILTER_FULL_INFORMATION 结构。
FilterAggregateBasicInformation	Buffer 参数指向的缓冲区接收微型筛选器驱动程序的 FILTER_AGGREGATE_BASIC_INFORMATION 结构。从Microsoft Windows Server 2003 SP1 和带有筛选器管理器汇总的 Windows XP SP2 开始，此 InformationClass 值可用。有关 Windows XP SP2 的筛选器管理器汇总包的详细信息，请参阅 Microsoft 知识库中的文章914882“Windows XP SP2的筛选器管理器汇总包”。
FilterAggregateStandardInformation	Buffer 参数指向的缓冲区接收微型筛选器驱动程序的 FILTER_AGGREGATE_STANDARD_INFORMATION 结构。未使用结构部分的 LegacyFilter。从 Windows Vista 开始，此 InformationClass 值可用。

[out] Buffer

指向接收请求信息的调用方分配的缓冲区的指针。缓冲区中返回的信息的类型由 InformationClass 参数定义。

[in] BufferSize

Buffer 参数指向的缓冲区的大小（以字节为单位）。调用方应根据给定 InformationClass 值设置此参数。

[out] BytesReturned

指向调用方分配的变量的指针，该变量接收 Buffer 指向的缓冲区中返回的字节数。如果 BufferSize 的输入值太小，FltGetFilterInformation 将返回STATUS_BUFFER_TOO_SMALL并将此变量设置为存储所请求信息的字节数。此参数是必需的，不能 NULL。

返回值

FltGetFilterInformation 返回STATUS_SUCCESS或适当的 NTSTATUS 值，例如以下值之一：

返回代码	描述
STATUS_BUFFER_TOO_SMALL	Buffer 参数指向的缓冲区不够大，无法存储请求的信息。这是一个错误代码。
STATUS_INVALID_PARAMETER	为 InformationClass 参数指定了无效值。例如，如果在 Windows Vista 之前的作系统上指定了 filterAggregateStandardInformation，则例程将返回STATUS_INVALID_PARAMETER。这是一个错误代码。