structure FLT_VOLUME_PROPERTIES (fltkernel.h)

Article
02/06/2025

La structure FLT_VOLUME_PROPERTIES est passée en tant que paramètre à FltGetVolumeProperties.

Syntaxe

typedef struct _FLT_VOLUME_PROPERTIES {
  DEVICE_TYPE    DeviceType;
  ULONG          DeviceCharacteristics;
  ULONG          DeviceObjectFlags;
  ULONG          AlignmentRequirement;
  USHORT         SectorSize;
  USHORT         Flags;
  UNICODE_STRING FileSystemDriverName;
  UNICODE_STRING FileSystemDeviceName;
  UNICODE_STRING RealDeviceName;
} FLT_VOLUME_PROPERTIES, *PFLT_VOLUME_PROPERTIES;

Membres

DeviceType

Reçoit le type d’appareil du volume. Doit être un type d’appareil de stockage valide, par exemple l’une des valeurs suivantes définies dans ntifs.h :

FILE_DEVICE_CD_ROM

FILE_DEVICE_DISK

FILE_DEVICE_DVD

FILE_DEVICE_MASS_STORAGE

FILE_DEVICE_NETWORK

FILE_DEVICE_VIRTUAL_DISK

Pour plus d’informations, consultez Spécification des types d’appareils.

DeviceCharacteristics

Reçoit les caractéristiques de l’appareil du volume. Pour plus d’informations, consultez l’entrée de référence pour IoCreateDevice.

DeviceObjectFlags

Reçoit les indicateurs d’objet de l’appareil pour le volume. Pour plus d’informations sur ces indicateurs, consultez les entrées de référence pour IoRegisterFileSystem et DEVICE_OBJECT.

AlignmentRequirement

Reçoit l’alignement de la mémoire tampon requis par l’appareil sous-jacent. La valeur doit être l’une des valeurs FILE_xxxx_ALIGNMENT définies dans ntifs.h. Pour plus d’informations, consultez DEVICE_OBJECT et Initialisation d’un objet device.

SectorSize

Reçoit la taille du secteur du volume, en octets.

Flags

Fournit une description supplémentaire du volume. Ce membre peut être égal à zéro ou à l’un des indicateurs suivants. Dans les versions antérieures à Windows 10, version 1607, ce membre a été nommé Reserved0 et réservé pour l’utilisation du système.

Valeur	Signification
VOL_PROP_FL_DAX_VOLUME	Cet indicateur indique que le volume est un volume d’accès direct (DAX).

FileSystemDriverName

UNICODE_STRING structure qui reçoit le nom de service du système de fichiers monté sur ce volume. La mémoire tampon de cette chaîne Unicode est contiguë à cette structure et n’a pas besoin d’être initialisée avant d’appeler FltGetVolumeProperties.

FileSystemDeviceName

UNICODE_STRING structure qui reçoit le nom de l’objet d’appareil du système de fichiers associé à ce volume. La mémoire tampon de cette chaîne Unicode est contiguë à cette structure et n’a pas besoin d’être initialisée avant d’appeler FltGetVolumeProperties.

RealDeviceName

UNICODE_STRING structure qui reçoit le nom de l’objet d’appareil de stockage associé à ce volume. Cette structure est vide pour les systèmes de fichiers réseau. La mémoire tampon de cette chaîne Unicode est contiguë à cette structure et n’a pas besoin d’être initialisée avant d’appeler FltGetVolumeProperties.