estrutura FILTER_AGGREGATE_STANDARD_INFORMATION (fltuserstructures.h)

Artigo
02/26/2024

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 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 valores a seguir.

Sinalizador	Significado
FLTFL_ASI_IS_MINIFILTER	O filtro é um minifiltro – use a parte MiniFilter 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á sinalizadores definidos 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 (em relação 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 (em relação 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á sinalizadores definidos 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 (em relação 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 sejam colocados em camadas corretamente acima e abaixo dos drivers de filtro herdados, mesmo que um ou mais drivers de filtro sejam carregados fora de ordem.

Comentários

A estrutura FILTER_AGGREGATE_STANDARD_INFORMATION pode ser alocada do pool paginado ou nãopagado. Essa estrutura é passada como um parâmetro para rotinas como:

A estrutura 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 cairá em um limite de 8 bytes.

Requisitos

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