estructura FILE_VALID_DATA_LENGTH_INFORMATION (ntddk.h)
La estructura FILE_VALID_DATA_LENGTH_INFORMATION se usa como argumento para ZwSetInformationFile.
Sintaxis
typedef struct _FILE_VALID_DATA_LENGTH_INFORMATION {
LARGE_INTEGER ValidDataLength;
} FILE_VALID_DATA_LENGTH_INFORMATION, *PFILE_VALID_DATA_LENGTH_INFORMATION;
Miembros
ValidDataLength
Especifica la nueva longitud de datos válida para el archivo. Este parámetro debe ser un valor positivo mayor que la longitud de datos válida actual, pero menor o igual que el tamaño de archivo actual.
Comentarios
La estructura FILE_VALID_DATA_LENGTH_INFORMATION se usa para establecer una nueva longitud de datos válida para un archivo en un volumen NTFS. La longitud de datos válida de un archivo es la longitud, en bytes, de los datos que se han escrito en el archivo. Estos datos válidos se extienden desde el principio del archivo hasta el último byte del archivo que no se ha cero o dejado sin inicializar.
Establecer esta información requiere FILE_WRITE_DATA acceso al archivo. Además, los usuarios no administrativos y remotos deben tener SeManageVolumePrivilege (SE_MANAGE_VOLUME_PRIVILEGE) para el volumen en el que reside el archivo.
Los controladores de filtro del sistema de archivos pueden resultar útiles para establecer una longitud de datos válida en los escenarios siguientes:
- Al escribir clústeres sin procesar directamente en el disco a través de un canal de hardware. Esto permite al controlador de filtro informar al sistema de archivos de que este intervalo contiene datos válidos que se pueden devolver al usuario.
- Al crear archivos grandes en los que el rendimiento es un problema. Esto evita el tiempo necesario para rellenar el archivo con ceros cuando se crea o extiende el archivo.
- Al extender de forma remota un archivo y escribir en el disco en un sistema de archivos de clúster de metadatos servidos.
Esta estructura debe alinearse en un límite de LONGLONG (8 bytes).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y versiones posteriores del sistema operativo Windows. |
| Encabezado | ntddk.h (incluya Ntddk.h) |