structure FILE_FS_CONTROL_INFORMATION (ntifs.h)

Article
12/21/2024

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 libre, en octets, requise pour que le démon Content-Indexing commence le filtrage de document.

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 libre est inférieure à ce seuil, un message d’avertissement est écrit dans le journal des événements de l’application 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 Content-Indexing continue à filtrer les documents. Si la quantité d’espace disque libre tombe en dessous de 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 par 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 effectue une entrée dans le journal des événements de l’application Windows. Combinaison compatible d’une ou plusieurs des opérations 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 sa limite de quota de disque affecté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 son seuil d’avertissement de quota attribué.
FILE_VC_LOG_VOLUME_LIMIT	Si elle est définie, une entrée du 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 elle est définie, une entrée du journal des événements est créée lorsque le seuil d’espace libre du volume est dépassé.
FILE_VC_QUOTA_ENFORCE	Si elles sont définies, les quotas sont appliqués au volume.
FILE_VC_QUOTA_TRACK	Si elles sont définies, 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. Ces valeurs sont utiles pour tester les valeurs d’indicateur.

Masque	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 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_QUERY_VOLUME_INFORMATION.

FILE_READ_DATA’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, ZwQueryVolumeInformationFileou ZwSetVolumeInformationFile doit être au moins sizeof (FILE_FS_CONTROL_INFORMATION).

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