estrutura FILTER_AGGREGATE_BASIC_INFORMATION (fltuserstructures.h)

Artigo
08/07/2023

A estrutura FILTER_AGGREGATE_BASIC_INFORMATION contém informações básicas para um minifiltro ou driver de filtro herdado.

Sintaxe

typedef struct _FILTER_AGGREGATE_BASIC_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG  FrameID;
      ULONG  NumberOfInstances;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } MiniFilter;
    struct {
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
    } LegacyFilter;
  } Type;
} FILTER_AGGREGATE_BASIC_INFORMATION, *PFILTER_AGGREGATE_BASIC_INFORMATION;

Membros

NextEntryOffset

Deslocamento de bytes da próxima entrada FILTER_AGGREGATE_BASIC_INFORMATION, se várias entradas estiverem presentes em um buffer. Esse membro será zero se nenhuma outra entrada seguir esta.

Flags

Indica se o driver de filtro é um filtro herdado ou um minifiltro. Esse membro deve ser um dos valores a seguir.

Sinalizador	Significado
FLTFL_AGGREGATE_INFO_IS_MINIFILTER	O filtro é um minifiltro – use a parte MiniFiltro da união.
FLTFL_AGGREGATE_INFO_IS_LEGACYFILTER	O filtro é um filtro herdado – use a parte LegacyFilter da união.

Type

Type.MiniFilter

Type.MiniFilter.FrameID

Índice baseado em zero do quadro atual.

Type.MiniFilter.NumberOfInstances

Número de instâncias que existem atualmente para o minifiltro.

Type.MiniFilter.FilterNameLength

Comprimento, em bytes, do nome do filtro.

Type.MiniFilter.FilterNameBufferOffset

Deslocamento de bytes do primeiro caractere da cadeia de caracteres de nome do filtro.

Type.MiniFilter.FilterAltitudeLength

Comprimento, em bytes, da cadeia de caracteres de altitude do minifiltro.

Type.MiniFilter.FilterAltitudeBufferOffset

Deslocamento de bytes do primeiro caractere da cadeia de caracteres de altitude do minifiltro.

Type.LegacyFilter

Type.LegacyFilter.FilterNameLength

Comprimento, em bytes, do nome do filtro.

Type.LegacyFilter.FilterNameBufferOffset

Deslocamento de bytes do primeiro caractere da cadeia de caracteres de nome do filtro.

Comentários

A estrutura FILTER_AGGREGATE_BASIC_INFORMATION é passada como um parâmetro para rotinas como FilterFindFirst, FilterFindNext, FilterGetInformation, FltEnumerateFilterInformation e FltGetFilterInformation.

Essa estrutura deve ser alinhada em um limite LONGLONG (8 bytes). Se um buffer contiver duas ou mais dessas estruturas, o valor NextEntryOffset em cada entrada, exceto a última, se enquadra em um limite de 8 bytes.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa estrutura 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 de atualizações do gerenciador de filtros para Windows XP SP2, confira o artigo 914882" O pacote cumulativo de atualizações do gerenciador de filtros para Windows XP SP2", na Base de Dados de Conhecimento Microsoft.
Cabeçalho	fltuserstructures.h (incluem FltUser.h, FltKernel.h)

Requisito

Valor

Cliente mínimo com suporte

Essa estrutura 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 de atualizações do gerenciador de filtros para Windows XP SP2, confira o artigo 914882" O pacote cumulativo de atualizações do gerenciador de filtros para Windows XP SP2", na Base de Dados de Conhecimento Microsoft.

Cabeçalho

fltuserstructures.h (incluem FltUser.h, FltKernel.h)