FILTER_AGGREGATE_BASIC_INFORMATION estrutura (fltuserstructures.h)

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 de 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 seguintes valores.

Bandeira	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.

Observações

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

Essa estrutura deve ser alinhada em um limite LONGLONG (8 bytes). Se um buffer contiver duas ou mais dessas estruturas, o nextEntryOffset valor em cada entrada, exceto o último, cairá em um limite de 8 bytes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Essa estrutura está disponível a partir do Microsoft Windows Server 2003 SP1 e do Windows XP SP2 com rollup do gerenciador de filtros. Para obter mais informações sobre o pacote cumulativo do gerenciador de filtros para Windows XP SP2, consulte o artigo 914882"O pacote cumulativo do gerenciador de filtros para Windows XP SP2", na Base de Dados de Conhecimento da Microsoft.
cabeçalho	fltuserstructures.h (incluem FltUser.h, FltKernel.h)

Consulte também

FILTER_AGGREGATE_STANDARD_INFORMATION

FILTER_FULL_INFORMATION

FilterFindClose

FilterFindFirst

FilterFindNext

FilterGetInformation

FltEnumerateFilterInformation

FltGetFilterInformation