FILTER_AGGREGATE_BASIC_INFORMATION
TOC
Collapse the table of content
Expand the table of content

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.

FlagMeaning

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

 

MiniFilter

 

FrameID

Zero-based index of the current frame.

NumberOfInstances

Number of instances that currently exist for the minifilter.

FilterNameLength

Length, in bytes, of the filter name.

FilterNameBufferOffset

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

FilterAltitudeLength

Length, in bytes, of the minifilter altitude string.

FilterAltitudeBufferOffset

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

LegacyFilter

 

FilterNameLength

Length, in bytes, of the filter name.

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

Version

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 or FltKernel.h)

See also

FILTER_AGGREGATE_STANDARD_INFORMATION
FILTER_FULL_INFORMATION
FilterFindClose
FilterFindFirst
FilterFindNext
FilterGetInformation
FltEnumerateFilterInformation
FltGetFilterInformation

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft