struttura FILE_VALID_DATA_LENGTH_INFORMATION (ntddk.h)
La struttura FILE_VALID_DATA_LENGTH_INFORMATION viene usata come argomento per ZwSetInformationFile.
Sintassi
typedef struct _FILE_VALID_DATA_LENGTH_INFORMATION {
LARGE_INTEGER ValidDataLength;
} FILE_VALID_DATA_LENGTH_INFORMATION, *PFILE_VALID_DATA_LENGTH_INFORMATION;
Members
ValidDataLength
Specifica la nuova lunghezza dei dati valida per il file. Questo parametro deve essere un valore positivo maggiore della lunghezza dei dati valida corrente, ma minore o uguale alla dimensione del file corrente.
Commenti
La struttura FILE_VALID_DATA_LENGTH_INFORMATION viene utilizzata per impostare una nuova lunghezza di dati valida per un file in un volume NTFS. La lunghezza dei dati valida di un file è la lunghezza, espressa in byte, dei dati scritti nel file. Questi dati validi si estendono dall'inizio del file all'ultimo byte nel file che non è stato azzerato o lasciato non inizializzato.
L'impostazione di queste informazioni richiede FILE_WRITE_DATA l'accesso al file. Inoltre, non amministratori e utenti remoti devono avere SeManageVolumePrivilege (SE_MANAGE_VOLUME_PRIVILEGE) per il volume in cui si trova il file.
I driver di filtro del file system possono risultare utili per impostare una lunghezza dei dati valida negli scenari seguenti:
- Quando si scrivono cluster non elaborati direttamente su disco tramite un canale hardware. Ciò consente al driver di filtro di informare il file system che questo intervallo contiene dati validi che possono essere restituiti all'utente.
- Quando si creano file di grandi dimensioni in cui le prestazioni sono un problema. In questo modo si evita il tempo necessario per riempire il file con zeri al momento della creazione o dell'estensione del file.
- Quando si estende in remoto un file e si scrive su disco in un file system del cluster di metadati serviti.
Questa struttura deve essere allineata su un limite di LONGLONG (8 byte).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows XP e versioni successive del sistema operativo Windows. |
| Intestazione | ntddk.h (include Ntddk.h) |