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

Статья
02/06/2025

Подпрограмма 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	Буфер, на который указывает параметр буфера , получает структуру INSTANCE_BASIC_INFORMATION для экземпляра.
InstanceFullInformation	Буфер, на который указывает параметр буфера, получает INSTANCE_FULL_INFORMATION структуру для экземпляра.
InstancePartialInformation	Буфер, на который указывает параметр буфера , получает структуру INSTANCE_PARTIAL_INFORMATION для экземпляра.
InstanceAggregateStandardInformation	Буфер, на который указывает параметр буфера , получает INSTANCE_AGGREGATE_STANDARD_INFORMATION структуру для экземпляра. устаревшей части структуры не используется. Эта структура доступна начиная с Windows Vista.

[out] Buffer

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

[in] BufferSize

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

[out] BytesReturned

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

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

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

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

Замечания

Если указатель на экземпляр мини-фильтра, эта подпрограмма возвращает сведения об экземпляре минифильтратора. Тип возвращаемых сведений об экземпляре определяется параметром InformationClass.

Требования

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