FILTER_AGGREGATE_STANDARD_INFORMATION estrutura (fltuserstructures.h)

A estrutura FILTER_AGGREGATE_STANDARD_INFORMATION contém informações sobre um minifiltro ou driver de filtro herdado.

Sintaxe

typedef struct _FILTER_AGGREGATE_STANDARD_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG  Flags;
      ULONG  FrameID;
      ULONG  NumberOfInstances;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } MiniFilter;
    struct {
      ULONG  Flags;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } LegacyFilter;
  } Type;
} FILTER_AGGREGATE_STANDARD_INFORMATION, *PFILTER_AGGREGATE_STANDARD_INFORMATION;

Membros

NextEntryOffset

Deslocamento de bytes da próxima entrada de FILTER_AGGREGATE_STANDARD_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_ASI_IS_MINIFILTER	O filtro é um minifiltro – use a parte MiniFiltro da união.
FLTFL_ASI_IS_LEGACYFILTER	O filtro é um filtro herdado : use a parte LegacyFilter da união.

Type

Type.MiniFilter

Variável de estrutura aninhada com os seguintes membros:

Type.MiniFilter.Flags

No momento, não há nenhum sinalizador definido para esse membro.

Type.MiniFilter.FrameID

Índice baseado em zero usado para identificar o quadro do gerenciador de filtros no qual o minifiltro está.

Type.MiniFilter.NumberOfInstances

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

Type.MiniFilter.FilterNameLength

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

Type.MiniFilter.FilterNameBufferOffset

Deslocamento de bytes (relativo ao início da estrutura) do primeiro caractere da cadeia de caracteres de nome do minifiltro Unicode. A cadeia de caracteres não é terminada em NULL.

Type.MiniFilter.FilterAltitudeLength

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

Type.MiniFilter.FilterAltitudeBufferOffset

Deslocamento de bytes (relativo ao início da estrutura) do primeiro caractere da cadeia de caracteres de altitude do minifiltro Unicode. A cadeia de caracteres não é terminada em NULL.

Type.LegacyFilter

Variável de estrutura aninhada com os seguintes membros:

Type.LegacyFilter.Flags

No momento, não há nenhum sinalizador definido para esse membro.

Type.LegacyFilter.FilterNameLength

Comprimento, em bytes, da cadeia de caracteres de nome do filtro herdado.

Type.LegacyFilter.FilterNameBufferOffset

Deslocamento de bytes (em relação ao início da estrutura) do primeiro caractere da cadeia de caracteres de nome de filtro herdado Unicode. A cadeia de caracteres não é terminada em NULL.

Type.LegacyFilter.FilterAltitudeLength

Comprimento, em bytes, da cadeia de caracteres de altitude do filtro herdado.

Type.LegacyFilter.FilterAltitudeBufferOffset

Deslocamento de bytes (relativo ao início da estrutura) do primeiro caractere da cadeia de caracteres de altitude do filtro herdado Unicode. A cadeia de caracteres não é terminada em NULL.

A partir do Windows Vista, as altitudes são atribuídas a drivers de filtro herdados com base no grupo de pedidos de carga do driver. Isso garante que os drivers de minifiltro coloquem a camada corretamente acima e abaixo dos drivers de filtro herdados, mesmo que um ou mais dos drivers de filtro sejam carregados fora de ordem.

Observações

A estrutura de FILTER_AGGREGATE_STANDARD_INFORMATION pode ser alocada do pool de páginas ou nãopagados. Essa estrutura é passada como um parâmetro para rotinas como:

• FilterFindFirst

• FilterFindNext

• FilterGetInformation

• FltEnumerateFilterInformation

• FltGetFilterInformation

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Essa estrutura está disponível a partir do Windows Vista.
cabeçalho	fltuserstructures.h (incluem FltUser.h, FltKernel.h)

Consulte também

FILTER_AGGREGATE_BASIC_INFORMATION

FILTER_FULL_INFORMATION

FilterFindFirst

FilterFindNext

FilterGetInformation

FltEnumerateFilterInformation

FltGetFilterInformation