Bagikan melalui

FSCTL_SET_ZERO_DATA kode kontrol

  • Artikel

Kode kontrol FSCTL_SET_ZERO_DATA mengisi rentang file tertentu dengan nol (0). Jika file jarang atau terkompresi, sistem file NTFS dapat membatalkan alokasi ruang disk dalam file. Ini mengatur rentang byte ke nol (0) tanpa memperluas ukuran file.

Untuk melakukan operasi ini dari driver, panggil FltFsControlFile dengan parameter berikut.

Parameter

  • Instans: Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

  • FileObject [in]: Penunjuk objek file ke file tempat menulis nol. Parameter ini diperlukan dan tidak boleh NULL.

  • FsControlCode [in]: Kode kontrol untuk operasi.

Gunakan FSCTL_SET_ZERO_DATA untuk operasi ini.

Anggota FileOffset adalah offset byte dari byte pertama yang diatur ke nol (0), dan anggota BeyondFinalZero adalah offset byte pertama melebihi byte nol terakhir (0).

Anggota Bendera di FILE_ZERO_DATA_INFORMATION_EX menentukan pengubah operasi. Misalnya, ketika Bendera diatur ke FILE_ZERO_DATA_INFORMATION_FLAG_PRESERVE_CACHED_DATA, konten cache yang sesuai dengan rentang file ini tidak dibersihkan.

  • InputBufferLength [in]: Ukuran buffer input, dalam byte.

  • OutputBuffer [out]: Tidak digunakan dengan operasi ini; atur ke NULL.

  • OutputBufferLength [out]: Tidak digunakan dengan operasi ini; atur ke nol.

Blok status

FltFsControlFile mengembalikan nilai STATUS_SUCCESS atau NTSTATUS yang sesuai.

Menampilkan kode Makna
STATUS _INSUFFICIENT_RESOURCES Tidak ada cukup memori untuk menyelesaikan operasi.
STATUS_INVALID_PARAMETER InputBufferLength lebih kecil dari ukuran struktur FILE_ZERO_DATA_INFORMATION atau file yang ditentukan adalah file metadata sistem atau direktori.
STATUS_ACCESS_DENIED FILE_ZERO_DATA_INFORMATION_FLAG_PRESERVE_CACHED_DATA diatur dari mode pengguna.
STATUS_MEDIA_WRITE_PROTECTED Volume saat ini dilindungi tulis.

Persyaratan

Jenis persyaratan Persyaratan
Header Ntifs.h (termasuk Ntifs.h)

Lihat juga

FltFsControlFile

FILE_ZERO_DATA_INFORMATION

FILE_ZERO_DATA_INFORMATION_EX