structure FILE_VALID_DATA_LENGTH_INFORMATION (ntddk.h)
La structure FILE_VALID_DATA_LENGTH_INFORMATION est utilisée comme argument pour ZwSetInformationFile.
Syntaxe
typedef struct _FILE_VALID_DATA_LENGTH_INFORMATION {
LARGE_INTEGER ValidDataLength;
} FILE_VALID_DATA_LENGTH_INFORMATION, *PFILE_VALID_DATA_LENGTH_INFORMATION;
Membres
ValidDataLength
Spécifie la nouvelle longueur de données valide pour le fichier. Ce paramètre doit être une valeur positive supérieure à la longueur de données valide actuelle, mais inférieure ou égale à la taille de fichier actuelle.
Remarques
La structure FILE_VALID_DATA_LENGTH_INFORMATION est utilisée pour définir une nouvelle longueur de données valide pour un fichier sur un volume NTFS. La longueur de données valide d’un fichier est la longueur, en octets, des données écrites dans le fichier. Cette données valides s’étend du début du fichier au dernier octet du fichier qui n’a pas été zéro ou non initialisé à gauche.
La définition de ces informations nécessite FILE_WRITE_DATA l’accès au fichier. En outre, les nonadministrateurs et les utilisateurs distants doivent avoir SeManageVolumePrivilege (SE_MANAGE_VOLUME_PRIVILEGE) pour le volume sur lequel réside le fichier.
Les pilotes de filtre de système de fichiers peuvent trouver utile de définir une longueur de données valide dans les scénarios suivants :
- Lors de l’écriture de clusters bruts directement sur le disque via un canal matériel. Cela permet au pilote de filtre d’informer le système de fichiers que cette plage contient des données valides qui peuvent être retournées à l’utilisateur.
- Lors de la création de fichiers volumineux où les performances sont un problème. Cela évite le temps nécessaire pour remplir le fichier avec des zéros lorsque le fichier est créé ou étendu.
- Lors de l’extension à distance d’un fichier et de l’écriture sur disque sur un système de fichiers de cluster de métadonnées servis.
Cette structure doit être alignée sur une limite LONGLONG (8 octets).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible sur Microsoft Windows XP et versions ultérieures du système d’exploitation Windows. |
| d’en-tête | ntddk.h (include Ntddk.h) |