structure FILTER_VOLUME_STANDARD_INFORMATION (fltuserstructures.h)

Article
02/29/2024

La structure de FILTER_VOLUME_STANDARD_INFORMATION allouée à l’appelant contient des informations pour un volume.

Syntaxe

typedef struct _FILTER_VOLUME_STANDARD_INFORMATION {
  ULONG               NextEntryOffset;
  ULONG               Flags;
  ULONG               FrameID;
  FLT_FILESYSTEM_TYPE FileSystemType;
  USHORT              FilterVolumeNameLength;
  WCHAR               FilterVolumeName[1];
} FILTER_VOLUME_STANDARD_INFORMATION, *PFILTER_VOLUME_STANDARD_INFORMATION;

Membres

NextEntryOffset

Décalage en lecture seule, en octets, de la structure FILTER_VOLUME_STANDARD_INFORMATION suivante si plusieurs structures sont présentes dans la mémoire tampon. Ce membre est égal à zéro si aucune autre structure ne suit celle-ci.

Flags

Masque de bits en lecture seule d’indicateurs définis par le système qui décrivent les attributs du volume. Voici des valeurs d’indicateur valides.

Indicateur	Signification
FLTFL_VSI_DETACHED_VOLUME	Volume dans qui n’est pas actuellement attaché à une pile de stockage.

FrameID

Membre en lecture seule utilisé pour identifier l’image du gestionnaire de filtres dans laquelle se trouve le volume.

FileSystemType

Membre en lecture seule utilisé pour identifier le type de système de fichiers utilisé sur le volume. Les valeurs possibles pour ce membre sont répertoriées dans FLT_FILESYSTEM_TYPE.

FilterVolumeNameLength

Longueur en lecture seule, en octets, du nom du volume.

FilterVolumeName[1]

Nom en lecture seule du volume de longueur FilterVolumeNameLength . Cette chaîne Unicode n’est pas terminée par null.

Remarques

Les routines d’énumération du gestionnaire de filtres, telles que FltEnumerateVolumeInformation, peuvent remplir une mémoire tampon avec des structures de type FILTER_VOLUME_STANDARD_INFORMATION où chaque structure représente un volume connu pour le gestionnaire de filtres. Cette liste de structures peut contenir plusieurs volumes portant le même nom. Pour plus d’informations, consultez Présentation des énumérations de volumes avec des noms de volumes en double.

La structure FILTER_VOLUME_STANDARD_INFORMATION doit être alignée sur une limite LONGLONG (8 octets). Si une mémoire tampon contient au moins deux de ces structures, la valeur NextEntryOffset dans chaque entrée se situe sur une limite de 8 octets.

Une structure FILTER_VOLUME_STANDARD_INFORMATION peut être allouée à partir d’un pool paginé ou non paginé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette structure est disponible à partir de Windows Vista.
En-tête	fltuserstructures.h (include FltUser.h, FltKernel.h)