estructura INSTANCE_AGGREGATE_STANDARD_INFORMATION (fltuserstructures.h)

Artículo
02/27/2024

La estructura de INSTANCE_AGGREGATE_STANDARD_INFORMATION asignada por el autor de la llamada contiene información estándar agregada sobre una instancia de controlador de minifiltro o un controlador de filtro heredado.

Sintaxis

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;

Miembros

NextEntryOffset

Desplazamiento de bytes de la siguiente estructura INSTANCE_AGGREGATE_STANDARD_INFORMATION si hay varias estructuras presentes en un búfer. Este miembro es cero si ninguna otra estructura sigue a esta.

Flags

Indica si el controlador de filtro es un controlador de filtro heredado o un controlador de minifiltro. Este miembro debe contener una de las marcas siguientes.

Marca	Significado
FLTFL_IASI_IS_MINIFILTER	El controlador de filtro es un controlador de minifiltro; use la parte MiniFilter de la unión.
FLTFL_IASI_IS_LEGACYFILTER	El controlador de filtro es un controlador de filtro heredado; use la parte LegacyFilter de la unión.

Type

Variable de estructura anidada con los siguientes miembros.

Type.MiniFilter

Type.MiniFilter.Flags

Máscara de bits de marcas que describen los atributos de la instancia de minifiltro. A continuación se muestran valores de marca válidos.

Marca	Significado
FLTFL_IASIM_DETACHED_VOLUME	El volumen no está asociado actualmente a una pila de almacenamiento.

Type.MiniFilter.FrameID

Índice de base cero usado para identificar el marco del administrador de filtros en el que se encuentra la instancia de minifiltro.

Type.MiniFilter.VolumeFileSystemType

Identifica el tipo de sistema de archivos al que está asociada la instancia de minifiltro. Los valores posibles para este miembro se muestran en FLT_FILESYSTEM_TYPE.

Type.MiniFilter.InstanceNameLength

Longitud, en bytes, del nombre de la instancia de minifiltro.

Type.MiniFilter.InstanceNameBufferOffset

Desplazamiento de bytes (relativo al principio de la estructura) del primer carácter de la cadena de nombre de instancia de minifiltro Unicode. Esta cadena no termina en NULL.

Type.MiniFilter.AltitudeLength

Longitud, en bytes, de la cadena de altitud de la instancia de minifiltro.

Type.MiniFilter.AltitudeBufferOffset

Desplazamiento de bytes (relativo al principio de la estructura) del primer carácter de la cadena de altitud de la instancia de minifiltro Unicode. Esta cadena no termina en NULL.

Type.MiniFilter.VolumeNameLength

Longitud, en bytes, del nombre del volumen al que está adjunta la instancia de minifiltro.

Type.MiniFilter.VolumeNameBufferOffset

Desplazamiento de bytes (relativo al principio de la estructura) del primer carácter de la cadena de nombre de volumen Unicode para el volumen al que está asociada la instancia de minifiltro. Esta cadena no termina en NULL.

Type.MiniFilter.FilterNameLength

Longitud, en bytes, del nombre del minifiltro del minifiltro del que se deriva la instancia de minifiltro.

Type.MiniFilter.FilterNameBufferOffset

Desplazamiento de bytes (relativo al principio de la estructura) del primer carácter de la cadena de nombre de minifiltro Unicode para el minifiltro desde el que se deriva la instancia de minifiltro. Esta cadena no termina en NULL.

Type.MiniFilter.SupportedFeatures

Las marcas de características admitidas para el filtro, según lo especificado por el valor supportedFeatures Registry de un minifiltro. Las características admitidas son una combinación OR bit a bit de las marcas siguientes.

Valor	Significado
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	El volumen admite operaciones de lectura descargadas.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	El volumen admite operaciones de escritura descargadas.
SUPPORTED_FS_FEATURES_QUERY_OPEN (0x04)	El volumen admite operaciones abiertas de consulta.
SUPPORTED_FS_FEATURES_BYPASS_IO (0x08)	El volumen admite BypassIO. Esta marca está disponible a partir de Windows 11.

Type.LegacyFilter

Variable de estructura anidada con los siguientes miembros.

Type.LegacyFilter.Flags

Máscara de bits de marcas que describen los atributos del filtro heredado. A continuación se muestran valores de marca válidos.

Marca	Significado
FLTFL_IASIL_DETACHED_VOLUME	El volumen no está asociado actualmente a una pila de almacenamiento.

Type.LegacyFilter.AltitudeLength

Longitud, en bytes, de la cadena de altitud de filtro heredada.

Type.LegacyFilter.AltitudeBufferOffset

Desplazamiento de bytes (relativo al principio de la estructura) del primer carácter de la cadena de altitud de filtro heredado Unicode. Esta cadena no termina en NULL.

A partir de Windows Vista, las altitudes se asignan a los controladores de filtro heredados en función del grupo de pedidos de carga del controlador. Esto garantiza que los controladores de minifiltro se superponen correctamente por encima y por debajo de los controladores de filtro heredados, incluso si uno o varios de los controladores de filtro se cargan fuera de orden.

Type.LegacyFilter.VolumeNameLength

Longitud, en bytes, del nombre del volumen al que está asociado el filtro heredado.

Type.LegacyFilter.VolumeNameBufferOffset

Desplazamiento de bytes (relativo al principio de la estructura) del primer carácter de la cadena de nombre de volumen Unicode para el volumen al que está asociado el filtro heredado. Esta cadena no termina en NULL.

Type.LegacyFilter.FilterNameLength

Longitud, en bytes, del nombre del filtro heredado.

Type.LegacyFilter.FilterNameBufferOffset

Desplazamiento de bytes (relativo al principio de la estructura) del primer carácter de la cadena de nombre de filtro heredado Unicode. Esta cadena no termina en NULL.

Type.LegacyFilter.SupportedFeatures

Marcas de características admitidas para el filtro heredado.

Las características admitidas son una combinación OR bit a bit de las marcas siguientes.

Valor	Significado
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	El volumen admite operaciones de lectura descargadas.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	El volumen admite operaciones de escritura descargadas.

Comentarios

Se puede asignar una estructura de tipo INSTANCE_AGGREGATE_STANDARD_INFORMATION desde un grupo paginado o no paginado. Esta estructura se pasa como parámetro a rutinas como las siguientes:

La estructura INSTANCE_AGGREGATE_STANDARD_INFORMATION debe alinearse en un límite de LONGLONG (8 bytes). Si un búfer contiene dos o más de estas estructuras, el valor NextEntryOffset de cada entrada cae en un límite de 8 bytes.