struktur FILE_VALID_DATA_LENGTH_INFORMATION (ntddk.h)
Struktur FILE_VALID_DATA_LENGTH_INFORMATION digunakan sebagai argumen untuk ZwSetInformationFile.
Sintaks
typedef struct _FILE_VALID_DATA_LENGTH_INFORMATION {
LARGE_INTEGER ValidDataLength;
} FILE_VALID_DATA_LENGTH_INFORMATION, *PFILE_VALID_DATA_LENGTH_INFORMATION;
Anggota
ValidDataLength
Menentukan panjang data baru yang valid untuk file. Parameter ini harus berupa nilai positif yang lebih besar dari panjang data yang valid saat ini, tetapi kurang dari atau sama dengan ukuran file saat ini.
Keterangan
Struktur FILE_VALID_DATA_LENGTH_INFORMATION digunakan untuk mengatur panjang data baru yang valid untuk file pada volume NTFS. Panjang data file yang valid adalah panjangnya, dalam byte, dari data yang telah ditulis ke file. Data yang valid ini diperluas dari awal file ke byte terakhir dalam file yang belum dinisialisasi atau tidak diinisialisasi.
Mengatur informasi ini memerlukan akses FILE_WRITE_DATA ke file. Selain itu, nonadministrators dan pengguna jarak jauh harus memiliki SeManageVolumePrivilege (SE_MANAGE_VOLUME_PRIVILEGE) untuk volume tempat file berada.
Driver filter sistem file dapat berguna untuk mengatur panjang data yang valid dalam skenario berikut:
- Saat menulis kluster mentah langsung ke disk melalui saluran perangkat keras. Ini memungkinkan driver filter untuk menginformasikan sistem file bahwa rentang ini berisi data valid yang dapat dikembalikan kepada pengguna.
- Saat membuat file besar di mana performa adalah masalah. Ini menghindari waktu yang diperlukan untuk mengisi file dengan nol saat file dibuat atau diperluas.
- Saat memperluas file dari jarak jauh dan menulis ke disk pada sistem file kluster metadata yang dilayani.
Struktur ini harus diselaraskan pada batas LONGLONG (8-byte).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan versi yang lebih baru dari sistem operasi Windows. |
| Header | ntddk.h (termasuk Ntddk.h) |