Función FltGetInstanceInformation (fltkernel.h)

Artículo
08/07/2023

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 valores siguientes.

Valor	Significado
InstanceBasicInformation	El búfer al que apunta el parámetro Buffer recibe una estructura INSTANCE_BASIC_INFORMATION para la instancia.
InstanceFullInformation	El búfer al que apunta el parámetro Buffer recibe una estructura de INSTANCE_FULL_INFORMATION para la instancia.
InstancePartialInformation	El búfer al que apunta el parámetro Buffer recibe una estructura 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 parámetro Buffer . El autor de la llamada debe establecer este parámetro según el valor 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 el búfer . 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 obligatorio y no puede ser 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 parámetro Buffer 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.

Comentarios

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 .