FILTER_AGGREGATE_BASIC_INFORMATION structure

The FILTER_AGGREGATE_BASIC_INFORMATION structure contains basic information for a minifilter or legacy filter driver.

Syntax

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;

Members

NextEntryOffset

Byte offset of the next FILTER_AGGREGATE_BASIC_INFORMATION entry, if multiple entries are present in a buffer. This member is zero if no other entries follow this one.

Flags

Indicates whether the filter driver is a legacy filter or a minifilter. This member must be one of the following values.

Flag Meaning
FLTFL_AGGREGATE_INFO_IS_MINIFILTER The filter is a minifilter - use the MiniFilter portion of the union.
FLTFL_AGGREGATE_INFO_IS_LEGACYFILTER The filter is a legacy filter - use the LegacyFilter portion of the union.

Type

Type.MiniFilter

Type.MiniFilter.FrameID

Zero-based index of the current frame.

Type.MiniFilter.NumberOfInstances

Number of instances that currently exist for the minifilter.

Type.MiniFilter.FilterNameLength

Length, in bytes, of the filter name.

Type.MiniFilter.FilterNameBufferOffset

Byte offset of the first character of the filter name string.

Type.MiniFilter.FilterAltitudeLength

Length, in bytes, of the minifilter altitude string.

Type.MiniFilter.FilterAltitudeBufferOffset

Byte offset of the first character of the minifilter altitude string.

Type.LegacyFilter

Type.LegacyFilter.FilterNameLength

Length, in bytes, of the filter name.

Type.LegacyFilter.FilterNameBufferOffset

Byte offset of the first character of the filter name string.

Remarks

The FILTER_AGGREGATE_BASIC_INFORMATION structure is passed as a parameter to routines such as FilterFindFirst, FilterFindNext, FilterGetInformation, FltEnumerateFilterInformation, and FltGetFilterInformation.

This structure must be aligned on a LONGLONG (8-byte) boundary. If a buffer contains two or more of these structures, the NextEntryOffset value in each entry, except the last, falls on an 8-byte boundary.

Requirements

   
Minimum supported client This structure is available starting with Microsoft Windows Server 2003 SP1 and Windows XP SP2 with filter manager rollup. For more information on the filter manager rollup package for Windows XP SP2, see article 914882, "The filter manager rollup package for Windows XP SP2," in the Microsoft Knowledge Base.
Header fltuserstructures.h (include FltUser.h, FltKernel.h)

See also

FILTER_AGGREGATE_STANDARD_INFORMATION

FILTER_FULL_INFORMATION

FilterFindClose

FilterFindFirst

FilterFindNext

FilterGetInformation

FltEnumerateFilterInformation

FltGetFilterInformation