FILTER_AGGREGATE_BASIC_INFORMATION structure (fltuserstructures.h)
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
Requirement | Value |
---|---|
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
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for