Função FltGetFilterInformation (fltkernel.h)

Artigo
02/26/2024

A rotina FltGetFilterInformation fornece informações sobre um driver de minifiltro.

Sintaxe

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

Ponteiro de filtro opaco para o chamador.

[in] InformationClass

Tipo de informação solicitada. Esse parâmetro pode ter um dos valores a seguir.

Valor	Significado
FilterFullInformation	O buffer apontado pelo parâmetro Buffer recebe uma estrutura FILTER_FULL_INFORMATION para o driver de minifiltro.
FilterAggregateBasicInformation	O buffer apontado pelo parâmetro Buffer recebe uma estrutura FILTER_AGGREGATE_BASIC_INFORMATION para o driver de minifiltro. Esse valor InformationClass está disponível a partir do Microsoft Windows Server 2003 SP1 e Windows XP SP2 com rollup do gerenciador de filtros. Para obter mais informações sobre o pacote cumulativo cumulativo do gerenciador de filtros para Windows XP SP2, consulte o artigo 914882: " O pacote cumulativo cumulativo do gerenciador de filtros para Windows XP SP2", na Base de Dados de Conhecimento da Microsoft.
FilterAggregateStandardInformation	O buffer apontado pelo parâmetro Buffer recebe uma estrutura de FILTER_AGGREGATE_STANDARD_INFORMATION para o driver de minifiltro. A parte LegacyFilter da estrutura não é utilizada. Esse valor InformationClass está disponível a partir do Windows Vista.

[out] Buffer

Ponteiro para um buffer alocado pelo chamador que recebe as informações solicitadas. O tipo das informações retornadas no buffer é definido pelo parâmetro InformationClass .

[in] BufferSize

Tamanho, em bytes, do buffer para o qual o parâmetro Buffer aponta. O chamador deve definir esse parâmetro de acordo com o valor de InformationClass fornecido.

[out] BytesReturned

Ponteiro para uma variável alocada pelo chamador que recebe o número de bytes retornados no buffer para o qual o Buffer aponta. Se o valor de entrada de BufferSize for muito pequeno, FltGetFilterInformation retornará STATUS_BUFFER_TOO_SMALL e definirá essa variável como o número de bytes necessários para armazenar as informações solicitadas. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

FltGetFilterInformation retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_BUFFER_TOO_SMALL	O buffer para o qual o parâmetro Buffer aponta não é grande o suficiente para armazenar as informações solicitadas. Este é um código de erro.
STATUS_INVALID_PARAMETER	Um valor inválido foi especificado para o parâmetro InformationClass . Por exemplo, se FilterAggregateStandardInformation for especificado em um sistema operacional antes do Windows Vista, a rotina retornará STATUS_INVALID_PARAMETER. Este é um código de erro.