FILTER_AGGREGATE_BASIC_INFORMATION 구조체(fltuserstructures.h)

아티클
08/07/2023

FILTER_AGGREGATE_BASIC_INFORMATION 구조에는 미니필터 또는 레거시 필터 드라이버에 대한 기본 정보가 포함되어 있습니다.

구문

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;

멤버

NextEntryOffset

버퍼에 여러 항목이 있는 경우 다음 FILTER_AGGREGATE_BASIC_INFORMATION 항목의 바이트 오프셋입니다. 다른 항목이 이 항목을 따르지 않는 경우 이 멤버는 0입니다.

Flags

필터 드라이버가 레거시 필터인지 미니필터인지 여부를 나타냅니다. 이 멤버는 다음 값 중 하나여야 합니다.

플래그	의미
FLTFL_AGGREGATE_INFO_IS_MINIFILTER	필터는 미니필터입니다. 공용 구조체의 MiniFilter 부분을 사용합니다.
FLTFL_AGGREGATE_INFO_IS_LEGACYFILTER	필터는 레거시 필터입니다. 공용 구조체의 LegacyFilter 부분을 사용합니다.

Type

Type.MiniFilter

Type.MiniFilter.FrameID

현재 프레임의 인덱스(0부터 시작)입니다.

Type.MiniFilter.NumberOfInstances

미니필터에 대해 현재 존재하는 인스턴스 수입니다.

Type.MiniFilter.FilterNameLength

필터 이름의 길이(바이트)입니다.

Type.MiniFilter.FilterNameBufferOffset

필터 이름 문자열의 첫 번째 문자에 대한 바이트 오프셋입니다.

Type.MiniFilter.FilterAltitudeLength

미니필터 고도 문자열의 길이(바이트)입니다.

Type.MiniFilter.FilterAltitudeBufferOffset

미니필터 고도 문자열의 첫 번째 문자에 대한 바이트 오프셋입니다.

Type.LegacyFilter

Type.LegacyFilter.FilterNameLength

필터 이름의 길이(바이트)입니다.

Type.LegacyFilter.FilterNameBufferOffset

필터 이름 문자열의 첫 번째 문자에 대한 바이트 오프셋입니다.

설명

FILTER_AGGREGATE_BASIC_INFORMATION 구조체는 FilterFindFirst, FilterFindNext, FilterGetInformation, FltEnumerateFilterInformation 및 FltGetFilterInformation과 같은 루틴에 매개 변수로 전달됩니다.

이 구조체는 LONGLONG(8 바이트) 경계에 맞춰야 합니다. 버퍼에 이러한 구조체가 두 개 이상 포함된 경우 마지막을 제외한 각 항목의 NextEntryOffset 값은 8 바이트 경계에 해당합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	이 구조는 필터 관리자 롤업이 포함된 Microsoft Windows Server 2003 SP1 및 Windows XP SP2부터 사용할 수 있습니다. Windows XP SP2용 필터 관리자 롤업 패키지에 대한 자세한 내용은 Microsoft 기술 자료의 "Windows XP SP2용 필터 관리자 롤업 패키지" 914882 문서를 참조하세요.
머리글	fltuserstructures.h(FltUser.h, FltKernel.h 포함)