FILTER_AGGREGATE_STANDARD_INFORMATION 구조체(fltuserstructures.h)

아티클
02/26/2024

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

구문

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;

멤버

NextEntryOffset

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

Flags

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

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

Type

Type.MiniFilter

다음 멤버를 사용하여 중첩된 구조 변수:

Type.MiniFilter.Flags

현재 이 멤버에 대해 정의된 플래그가 없습니다.

Type.MiniFilter.FrameID

미니필터가 있는 필터 관리자 프레임을 식별하는 데 사용되는 인덱스(0부터 시작)입니다.

Type.MiniFilter.NumberOfInstances

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

Type.MiniFilter.FilterNameLength

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

Type.MiniFilter.FilterNameBufferOffset

유니코드 미니필터 이름 문자열의 첫 번째 문자에 대한 바이트 오프셋(구조체의 시작 부분을 기준으로)입니다. 문자열이 NULL로 종료되지 않았습니다.

Type.MiniFilter.FilterAltitudeLength

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

Type.MiniFilter.FilterAltitudeBufferOffset

유니코드 미니필터 고도 문자열의 첫 번째 문자에 대한 바이트 오프셋(구조의 시작 부분을 기준으로)입니다. 문자열이 NULL로 종료되지 않았습니다.

Type.LegacyFilter

다음 멤버를 사용하여 중첩된 구조 변수:

Type.LegacyFilter.Flags

현재 이 멤버에 대해 정의된 플래그가 없습니다.

Type.LegacyFilter.FilterNameLength

레거시 필터 이름 문자열의 길이(바이트)입니다.

Type.LegacyFilter.FilterNameBufferOffset

유니코드 레거시 필터 이름 문자열의 첫 번째 문자에 대한 바이트 오프셋(구조의 시작 부분을 기준으로)입니다. 문자열이 NULL로 종료되지 않았습니다.

Type.LegacyFilter.FilterAltitudeLength

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

Type.LegacyFilter.FilterAltitudeBufferOffset

유니코드 레거시 필터 고도 문자열의 첫 번째 문자에 대한 바이트 오프셋(구조의 시작 부분에 상대적)입니다. 문자열이 NULL로 종료되지 않았습니다.

Windows Vista부터 고도는 드라이버의 부하 순서 그룹에 따라 레거시 필터 드라이버에 할당됩니다. 이렇게 하면 하나 이상의 필터 드라이버가 순서대로 로드되더라도 미니필터 드라이버가 레거시 필터 드라이버 위와 아래에 올바르게 계층화됩니다.

설명

FILTER_AGGREGATE_STANDARD_INFORMATION 구조체는 페이징된 풀 또는 비페이지 풀에서 할당할 수 있습니다. 이 구조체는 다음과 같은 루틴에 매개 변수로 전달됩니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	이 구조는 Windows Vista부터 사용할 수 있습니다.
머리글	fltuserstructures.h(FltUser.h, FltKernel.h 포함)