FltGetInstanceInformation 函数 (fltkernel.h)

项目
08/07/2023

FltGetInstanceInformation 例程返回有关微筛选器驱动程序实例的信息。

语法

NTSTATUS FLTAPI FltGetInstanceInformation(
  [in]  PFLT_INSTANCE              Instance,
  [in]  INSTANCE_INFORMATION_CLASS InformationClass,
  [out] PVOID                      Buffer,
  [in]  ULONG                      BufferSize,
  [out] PULONG                     BytesReturned
);

参数

[in] Instance

调用方不透明的实例指针。

[in] InformationClass

请求的信息类型。此参数可以具有以下值之一。

值	含义
InstanceBasicInformation	Buffer 参数指向的缓冲区接收实例的INSTANCE_BASIC_INFORMATION 结构。
InstanceFullInformation	Buffer 参数指向的缓冲区接收实例的INSTANCE_FULL_INFORMATION 结构。
InstancePartialInformation	Buffer 参数指向的缓冲区接收实例的INSTANCE_PARTIAL_INFORMATION 结构。
InstanceAggregateStandardInformation	Buffer 参数指向的缓冲区接收实例的INSTANCE_AGGREGATE_STANDARD_INFORMATION 结构。未使用结构的 LegacyFilter 部分。此结构从 Windows Vista 开始可用。

[out] Buffer

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

[in] BufferSize

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

[out] BytesReturned

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

返回值

FltGetInstanceInformation 返回STATUS_SUCCESS或相应的 NTSTATUS 值，例如以下值之一：

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