FILE_VALID_DATA_LENGTH_INFORMATION-Struktur (ntddk.h)
Die FILE_VALID_DATA_LENGTH_INFORMATION-Struktur wird als Argument für ZwSetInformationFile verwendet.
Syntax
typedef struct _FILE_VALID_DATA_LENGTH_INFORMATION {
LARGE_INTEGER ValidDataLength;
} FILE_VALID_DATA_LENGTH_INFORMATION, *PFILE_VALID_DATA_LENGTH_INFORMATION;
Member
ValidDataLength
Gibt die neue gültige Datenlänge für die Datei an. Dieser Parameter muss ein positiver Wert sein, der größer als die aktuell gültige Datenlänge, aber kleiner oder gleich der aktuellen Dateigröße ist.
Hinweise
Die FILE_VALID_DATA_LENGTH_INFORMATION-Struktur wird verwendet, um eine neue gültige Datenlänge für eine Datei auf einem NTFS-Volume festzulegen. Die gültige Datenlänge einer Datei ist die Länge der In die Datei geschriebenen Daten in Bytes. Diese gültigen Daten reichen vom Anfang der Datei bis zum letzten Byte in der Datei, die nicht null oder nicht initialisiert wurde.
Das Festlegen dieser Informationen erfordert FILE_WRITE_DATA Zugriff auf die Datei. Darüber hinaus müssen Nichtadministratoren und Remotebenutzer über SeManageVolumePrivilege (SE_MANAGE_VOLUME_PRIVILEGE) für das Volume verfügen, auf dem sich die Datei befindet.
Dateisystemfiltertreiber können es in den folgenden Szenarien als nützlich empfinden, eine gültige Datenlänge festzulegen:
- Beim Schreiben von rohen Clustern direkt auf den Datenträger über einen Hardwarekanal. Dadurch kann der Filtertreiber das Dateisystem darüber informieren, dass dieser Bereich gültige Daten enthält, die an den Benutzer zurückgegeben werden können.
- Beim Erstellen großer Dateien, bei denen die Leistung ein Problem ist. Dadurch wird die Zeit vermieden, die benötigt wird, um die Datei mit Nullen zu füllen, wenn die Datei erstellt oder erweitert wird.
- Wenn Sie eine Datei remote erweitern und auf einen Datenträger in einem Bereitgestellten Metadatenclusterdateisystem schreiben.
Diese Struktur muss an einer LONGLONG-Grenze (8 Byte) ausgerichtet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar unter Microsoft Windows XP und höheren Versionen des Windows-Betriebssystems. |
| Kopfzeile | ntddk.h (include Ntddk.h) |