FILE_FS_SIZE_INFORMATION structure (ntddk.h)

Article
03/01/2024

La structure FILE_FS_SIZE_INFORMATION est utilisée pour interroger les informations de taille de secteur d’un volume de système de fichiers.

Syntaxe

typedef struct _FILE_FS_SIZE_INFORMATION {
  LARGE_INTEGER TotalAllocationUnits;
  LARGE_INTEGER AvailableAllocationUnits;
  ULONG         SectorsPerAllocationUnit;
  ULONG         BytesPerSector;
} FILE_FS_SIZE_INFORMATION, *PFILE_FS_SIZE_INFORMATION;

Membres

TotalAllocationUnits

Nombre total d’unités d’allocation sur le volume qui sont disponibles pour l’utilisateur associé au thread appelant.

Microsoft Windows 2000 et versions ultérieures : Si des quotas par utilisateur sont en cours d’utilisation, cette valeur peut être inférieure au nombre total d’unités d’allocation sur le disque.

AvailableAllocationUnits

Nombre total d’unités d’allocation gratuites sur le volume qui sont disponibles pour l’utilisateur associé au thread appelant.

Windows 2000 et versions ultérieures : Si des quotas par utilisateur sont en cours d’utilisation, cette valeur peut être inférieure au nombre total d’unités d’allocation gratuites sur le disque.

SectorsPerAllocationUnit

Nombre de secteurs dans chaque unité d’allocation.

BytesPerSector

Nombre d’octets dans chaque secteur.

Remarques

Ces informations peuvent être interrogées de l’une des manières suivantes :

Appelez FltQueryVolumeInformation ou ZwQueryVolumeInformationFile, en passant FileFsSizeInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_FS_SIZE_INFORMATION-allouée à l’appelant comme valeur de FileInformation.
Créez un IRP avec le code de fonction principal IRP_MJ_QUERY_VOLUME_INFORMATION.

Aucun droit d’accès spécifique n’est requis pour interroger ces informations. Par conséquent, ces informations sont disponibles tant que le volume est accessible via un handle ouvert au volume lui-même, ou à un fichier ou un répertoire sur le volume.

La taille de la mémoire tampon passée dans le paramètre FileInformation à FltQueryVolumeInformation ou ZwQueryVolumeInformationFile doit être au moins sizeof (FILE_FS_SIZE_INFORMATION).

Cette structure doit être alignée sur une limite LONGLONG (8 octets).

Configuration requise

Condition requise	Valeur
En-tête	ntddk.h (inclure Ntddk.h, Ntifs.h, Fltkernel.h)

Voir aussi

FltQueryVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

ZwQueryVolumeInformationFile

Partager via