FILE_FS_CONTROL_INFORMATION structure (ntifs.h)

Article
10/04/2023

La structure FILE_FS_CONTROL_INFORMATION est utilisée pour interroger ou définir des informations de contrôle pour les fichiers d’un répertoire.

Syntaxe

typedef struct _FILE_FS_CONTROL_INFORMATION {
  LARGE_INTEGER FreeSpaceStartFiltering;
  LARGE_INTEGER FreeSpaceThreshold;
  LARGE_INTEGER FreeSpaceStopFiltering;
  LARGE_INTEGER DefaultQuotaThreshold;
  LARGE_INTEGER DefaultQuotaLimit;
  ULONG         FileSystemControlFlags;
} FILE_FS_CONTROL_INFORMATION, *PFILE_FS_CONTROL_INFORMATION;

Membres

FreeSpaceStartFiltering

Quantité minimale d’espace disque disponible, en octets, requise pour que le démon d’indexation de contenu commence le filtrage des documents.

FreeSpaceThreshold

Quantité minimale d’espace disque libre, en octets, requise pour que le service d’indexation continue à filtrer les documents et à fusionner des listes de mots. Si la quantité d’espace disque disponible est inférieure à ce seuil, un message d’avertissement est écrit dans le journal des événements des applications Microsoft Windows. Le filtrage et la fusion sont arrêtés jusqu’à ce que l’espace soit libéré.

FreeSpaceStopFiltering

Quantité minimale d’espace disque libre, en octets, requise pour que le démon d’indexation du contenu poursuive le filtrage des documents. Si la quantité d’espace disque disponible est inférieure à ce seuil, le filtrage des documents est arrêté.

DefaultQuotaThreshold

Seuil d’avertissement de quota de disque par utilisateur par défaut pour le volume.

DefaultQuotaLimit

Limite de quota de disque par utilisateur par défaut pour le volume.

FileSystemControlFlags

Masque de bits des indicateurs qui contrôlent l’application du quota et la journalisation des événements de quota liés à l’utilisateur sur le volume. La journalisation crée une entrée dans le journal des événements des applications Windows. Combinaison compatible d’une ou plusieurs des options suivantes :

Indicateur de contrôle du système de fichiers	Signification
FILE_VC_CONTENT_INDEX_DISABLED	Si elle est définie, l’indexation du contenu est désactivée.
FILE_VC_LOG_QUOTA_LIMIT	Si elle est définie, une entrée de journal des événements est créée lorsque l’utilisateur dépasse la limite de quota de disque qui lui est attribuée.
FILE_VC_LOG_QUOTA_THRESHOLD	Si elle est définie, une entrée de journal des événements est créée lorsque l’utilisateur dépasse le seuil d’avertissement du quota qui lui est attribué.
FILE_VC_LOG_VOLUME_LIMIT	Si elle est définie, une entrée de journal des événements est créée lorsque la limite d’espace libre du volume est dépassée.
FILE_VC_LOG_VOLUME_THRESHOLD	Si cette option est définie, une entrée de journal des événements est créée lorsque le seuil d’espace libre du volume est dépassé.
FILE_VC_QUOTA_ENFORCE	S’il est défini, des quotas sont appliqués sur le volume.
FILE_VC_QUOTA_TRACK	S’ils sont définis, les quotas sont suivis sur le volume.
FILE_VC_QUOTAS_INCOMPLETE	Si elle est définie, les informations de quota pour le volume sont incomplètes.
FILE_VC_QUOTAS_REBUILDING	S’il est défini, le système de fichiers régénère les informations de quota pour le volume.

En outre, les masques d’indicateur suivants sont définis. Celles-ci sont utiles pour tester les valeurs d’indicateur.

Mask	Valeur
FILE_VC_QUOTA_MASK	FILE_VC_QUOTA_ENFORCE \| FILE_VC_QUOTA_TRACK
FILE_VC_QUOTA_NONE	~FILE_VC_QUOTA_ENFORCE & ~FILE_VC_QUOTA_TRACK
FILE_VC_VALID_MASK	Combinaison ORed de tous les indicateurs du tableau ci-dessus.

Remarques

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

Appelez FltQueryVolumeInformation ou ZwQueryVolumeInformationFile, en passant FileFsControlInformation comme valeur de FileInformationClass et en transmettant une mémoire tampon FILE_FS_CONTROL_INFORMATION structurée par l’appelant comme valeur de FileInformation.
Créez un IRP avec le code de fonction principal IRP_MJ_QUERY_VOLUME_INFORMATION.

FILE_READ_DATA l’accès au volume est nécessaire pour interroger ces informations.

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

Appelez FltSetVolumeInformation ou ZwSetVolumeInformationFile, en passant FileFsControlInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_FS_CONTROL_INFORMATION-structurée par l’appelant comme valeur de FileInformation.
Créez un IRP avec le code de fonction principal IRP_MJ_SET_VOLUME_INFORMATION.

FILE_WRITE_DATA’accès au volume est nécessaire pour définir ces informations.

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

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