Función FltGetFilterInformation (fltkernel.h)

Artículo
08/07/2023

La rutina FltGetFilterInformation proporciona información sobre un controlador de minifiltro.

Sintaxis

NTSTATUS FLTAPI FltGetFilterInformation(
  [in]  PFLT_FILTER              Filter,
  [in]  FILTER_INFORMATION_CLASS InformationClass,
  [out] PVOID                    Buffer,
  [in]  ULONG                    BufferSize,
  [out] PULONG                   BytesReturned
);

Parámetros

[in] Filter

Puntero de filtro 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
FilterFullInformation	El búfer al que apunta el parámetro Buffer recibe una estructura de FILTER_FULL_INFORMATION para el controlador de minifiltro.
FilterAggregateBasicInformation	El búfer al que apunta el parámetro Buffer recibe una estructura de FILTER_AGGREGATE_BASIC_INFORMATION para el controlador de minifiltro. Este valor informationClass está disponible a partir de Microsoft Windows Server 2003 SP1 y Windows XP SP2 con el paquete acumulativo del administrador de filtros. Para obtener más información sobre el paquete acumulativo del administrador de filtros para Windows XP SP2, consulte el artículo 914882, " El paquete acumulativo del administrador de filtros para Windows XP SP2", en Microsoft Knowledge Base.
FilterAggregateStandardInformation	El búfer al que apunta el parámetro Buffer recibe una estructura de FILTER_AGGREGATE_STANDARD_INFORMATION para el controlador de minifiltro. La parte LegacyFilter de la estructura no se utiliza. Este valor informationClass 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, FltGetFilterInformation 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

FltGetFilterInformation 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 se especifica FilterAggregateStandardInformation en un sistema operativo anterior a Windows Vista, la rutina devuelve STATUS_INVALID_PARAMETER. Se trata de un código de error.