structure FLT_VOLUME_PROPERTIES (fltkernel.h)

Article
08/07/2023

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 de périphérique de stockage valide, tel qu’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 de 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 d’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 d’appareil.

SectorSize

Reçoit la taille du secteur de 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 était nommé Reserved0 et réservé à 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 de 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 de périphérique 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.