structure FILE_FS_CONTROL_INFORMATION (ntifs.h)

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, nécessaire au démon Content-Indexing pour commencer le filtrage de documents.

FreeSpaceThreshold

Quantité minimale d’espace disque libre, en octets, requise pour que le service d’indexation continue de filtrer les documents et de 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 interrompus jusqu’à ce que l’espace soit libéré.

FreeSpaceStopFiltering

Quantité minimale d’espace disque disponible, en octets, nécessaire pour que le démon Content-Indexing continue le filtrage des documents. Si la quantité d’espace disque libre 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 effectue une entrée dans le journal des événements de l’application 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 de 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 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 elle 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 Si la valeur est définie, les quotas sont appliqués sur le volume.
FILE_VC_QUOTA_TRACK S’il est défini, 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 Si elle est définie, le système de fichiers reconstruit les informations de quota pour le volume.
 

En outre, les masques d’indicateur suivants sont définis. Ils 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’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 allouée par l’appelant, FILE_FS_CONTROL_INFORMATION structurée 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 requis 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).

Configuration requise

   
En-tête ntifs.h (include Ntifs.h, Fltkernel.h)

Voir aussi

FltQueryVolumeInformation

FltSetVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

IRP_MJ_SET_VOLUME_INFORMATION

ZwQueryVolumeInformationFile

ZwSetVolumeInformationFile