INSTANCE_AGGREGATE_STANDARD_INFORMATION 구조체(fltuserstructures.h)

아티클
08/07/2023

호출자가 할당한 INSTANCE_AGGREGATE_STANDARD_INFORMATION 구조에는 미니필터 드라이버 instance 또는 레거시 필터 드라이버에 대한 집계 표준 정보가 포함되어 있습니다.

구문

typedef struct _INSTANCE_AGGREGATE_STANDARD_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG               Flags;
      ULONG               FrameID;
      FLT_FILESYSTEM_TYPE VolumeFileSystemType;
      USHORT              InstanceNameLength;
      USHORT              InstanceNameBufferOffset;
      USHORT              AltitudeLength;
      USHORT              AltitudeBufferOffset;
      USHORT              VolumeNameLength;
      USHORT              VolumeNameBufferOffset;
      USHORT              FilterNameLength;
      USHORT              FilterNameBufferOffset;
      ULONG               SupportedFeatures;
    } MiniFilter;
    struct {
      ULONG  Flags;
      USHORT AltitudeLength;
      USHORT AltitudeBufferOffset;
      USHORT VolumeNameLength;
      USHORT VolumeNameBufferOffset;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      ULONG  SupportedFeatures;
    } LegacyFilter;
  } Type;
} INSTANCE_AGGREGATE_STANDARD_INFORMATION, *PINSTANCE_AGGREGATE_STANDARD_INFORMATION;

멤버

NextEntryOffset

버퍼에 여러 구조체가 있는 경우 다음 INSTANCE_AGGREGATE_STANDARD_INFORMATION 구조체의 바이트 오프셋입니다. 다른 구조체가 이 구조체를 따르지 않으면 이 멤버는 0입니다.

Flags

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

플래그	의미
FLTFL_IASI_IS_MINIFILTER	필터 드라이버는 미니필터 드라이버입니다. 는 공용 구조체의 MiniFilter 부분을 사용합니다.
FLTFL_IASI_IS_LEGACYFILTER	필터 드라이버는 레거시 필터 드라이버입니다. 는 공용 구조체의 LegacyFilter 부분을 사용합니다.

Type

다음 멤버를 사용하는 중첩된 구조 변수입니다.

Type.MiniFilter

Type.MiniFilter.Flags

미니필터 instance 특성을 설명하는 플래그의 비트 마스크입니다. 다음은 유효한 플래그 값입니다.

플래그	의미
FLTFL_IASIM_DETACHED_VOLUME	볼륨이 현재 스토리지 스택에 연결되지 않았습니다.

Type.MiniFilter.FrameID

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

Type.MiniFilter.VolumeFileSystemType

미니필터 instance 연결된 파일 시스템의 형식을 식별합니다. 이 멤버에 대한 가능한 값은 FLT_FILESYSTEM_TYPE 나열됩니다.

Type.MiniFilter.InstanceNameLength

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

Type.MiniFilter.InstanceNameBufferOffset

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

Type.MiniFilter.AltitudeLength

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

Type.MiniFilter.AltitudeBufferOffset

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

Type.MiniFilter.VolumeNameLength

미니필터 instance 연결된 볼륨의 볼륨 이름의 길이(바이트)입니다.

Type.MiniFilter.VolumeNameBufferOffset

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

Type.MiniFilter.FilterNameLength

미니필터 instance 파생된 미니필터의 미니필터 이름의 길이(바이트)입니다.

Type.MiniFilter.FilterNameBufferOffset

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

Type.MiniFilter.SupportedFeatures

미니필터의 SupportedFeatures 레지스트리 값에 지정된 대로 필터에 대해 지원되는 기능 플래그입니다. 지원되는 기능은 다음 플래그의 비트 OR 조합입니다.

값	의미
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	볼륨은 오프로드된 읽기 작업을 지원합니다.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	볼륨은 오프로드된 쓰기 작업을 지원합니다.
SUPPORTED_FS_FEATURES_QUERY_OPEN (0x04)	볼륨은 쿼리 열기 작업을 지원합니다.
SUPPORTED_FS_FEATURES_BYPASS_IO (0x08)	볼륨은 BypassIO를 지원합니다. 이 플래그는 Windows 11 시작해서 사용할 수 있습니다.

Type.LegacyFilter

다음 멤버를 사용하는 중첩된 구조 변수입니다.

Type.LegacyFilter.Flags

레거시 필터의 특성을 설명하는 플래그의 비트 마스크입니다. 다음은 유효한 플래그 값입니다.

플래그	의미
FLTFL_IASIL_DETACHED_VOLUME	볼륨이 현재 스토리지 스택에 연결되지 않았습니다.

Type.LegacyFilter.AltitudeLength

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

Type.LegacyFilter.AltitudeBufferOffset

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

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

Type.LegacyFilter.VolumeNameLength

레거시 필터가 연결된 볼륨의 볼륨 이름 길이(바이트)입니다.

Type.LegacyFilter.VolumeNameBufferOffset

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

Type.LegacyFilter.FilterNameLength

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

Type.LegacyFilter.FilterNameBufferOffset

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

Type.LegacyFilter.SupportedFeatures

레거시 필터에 대해 지원되는 기능 플래그입니다.

지원되는 기능은 다음 플래그의 비트 OR 조합입니다.

값	의미
SUPPORTED_FS_FEATURES_OFFLOAD_READ(0x01)	볼륨은 오프로드된 읽기 작업을 지원합니다.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE(0x02)	볼륨은 오프로드된 쓰기 작업을 지원합니다.