Función FltGetInstanceInformation (fltkernel.h)

Artículo
02/06/2025

La rutina FltGetInstanceInformation devuelve información sobre una instancia de controlador de minifiltro.

Sintaxis

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

Parámetros

[in] Instance

Puntero de instancia opaco para el autor de la llamada.

[in] InformationClass

Tipo de información solicitada. Este parámetro puede tener uno de los siguientes valores.

Valor	Significado
InstanceBasicInformation	El búfer al que apunta el parámetro buffer de recibe una estructura de INSTANCE_BASIC_INFORMATION para la instancia.
instanceFullInformation	El búfer al que apunta el parámetro buffer de recibe una estructura INSTANCE_FULL_INFORMATION para la instancia.
InstancePartialInformation	El búfer al que apunta el parámetro buffer de recibe una estructura de INSTANCE_PARTIAL_INFORMATION para la instancia.
InstanceAggregateStandardInformation	El búfer al que apunta el parámetro buffer recibe una estructura INSTANCE_AGGREGATE_STANDARD_INFORMATION para la instancia. La parte LegacyFilter de la estructura no se utiliza. Esta estructura está disponible a partir de Windows Vista.

[out] Buffer

Puntero a un búfer asignado por el autor de la llamada que recibe la información solicitada. El tipo de la información devuelta en el búfer se define mediante el parámetro InformationClass.

[in] BufferSize

Tamaño, en bytes, del búfer al que apunta el Búfer parámetro. El autor de la llamada debe establecer este parámetro según el valor de InformationClass especificado.

[out] BytesReturned

Puntero a una variable asignada por el autor de la llamada que recibe el número de bytes devueltos en el búfer al que apunta buffer . Si el valor de entrada de BufferSize es demasiado pequeño, FltGetInstanceInformation devuelve STATUS_BUFFER_TOO_SMALL y establece esta variable en el número de bytes necesarios para almacenar la información solicitada. Este parámetro es necesario y no se puede null.

Valor devuelto

FltGetInstanceInformation devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_BUFFER_TOO_SMALL	El búfer al que apunta el Búfer no es lo suficientemente grande como para almacenar la información solicitada. Se trata de un código de error.
STATUS_INVALID_PARAMETER	Se especificó un valor no válido para el parámetro InformationClass. Por ejemplo, si instanceAggregateStandardInformation se especifica en los sistemas operativos anteriores a Windows Vista, la rutina devolverá STATUS_INVALID_PARAMETER. Se trata de un código de error.

Observaciones

Dado un puntero a una instancia de minifiltro, esta rutina devuelve información sobre la instancia de minifiltro. El tipo de información de instancia devuelta viene determinado por el parámetro InformationClass.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya FltKernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	<= APC_LEVEL