Função FltGetInstanceInformation (fltkernel.h)

Artigo
02/06/2025

A rotina FltGetInstanceInformation retorna informações sobre uma instância de driver de minifiltro.

Sintaxe

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

Ponteiro de instância opaco para o chamador.

[in] InformationClass

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

Valor	Significado
InstanceBasicInformation	O buffer apontado pelo parâmetro do Buffer recebe uma estrutura de INSTANCE_BASIC_INFORMATION para a instância.
InstanceFullInformation	O buffer apontado pelo parâmetro do Buffer recebe uma estrutura de INSTANCE_FULL_INFORMATION para a instância.
InstancePartialInformation	O buffer apontado pelo parâmetro do Buffer recebe uma estrutura de INSTANCE_PARTIAL_INFORMATION para a instância.
InstanceAggregateStandardInformation	O buffer apontado pelo parâmetro do Buffer recebe uma estrutura de INSTANCE_AGGREGATE_STANDARD_INFORMATION para a instância. A parte LegacyFilter da estrutura não é utilizada. Essa estrutura está disponível a partir do Windows Vista.

[out] Buffer

Ponteiro para um buffer alocado por 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 ao qual o Buffer parâmetro aponta. O chamador deve definir esse parâmetro de acordo com o valor informationClass fornecido.

[out] BytesReturned

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

Valor de retorno

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

Código de retorno	Descrição
STATUS_BUFFER_TOO_SMALL	O buffer ao qual o buffer de 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 InstanceAggregateStandardInformation for especificado nos sistemas operacionais antes do Windows Vista, a rotina retornará STATUS_INVALID_PARAMETER. Este é um código de erro.

Observações

Dado um ponteiro para uma instância de minifiltro, essa rotina retorna informações sobre a instância do minifiltro. O tipo de informação de instância retornada é determinado pelo parâmetro InformationClass.