Bagikan melalui

FSCTL_FILE_LEVEL_TRIM IOCTL (winioctl.h)

Menunjukkan rentang dalam file yang ditentukan yang tidak perlu disimpan oleh sistem penyimpanan.

Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // Handle to a file
  FSCTL_FILE_LEVEL_TRIM,            // dwIoControlCode
  (LPVOID) lpInBuffer,              // Input buffer
  (DWORD) nInBufferSize,            // Size of input buffer
  (LPVOID) lpOutBuffer,             // Output buffer
  (DWORD) nOutBufferSize,           // Size of output buffer
  (LPDWORD) lpBytesReturned,        // Number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

Keterangan

Kode kontrol FSCTL_FILE_LEVEL_TRIM adalah petunjuk untuk sistem penyimpanan yang mendasar. Ketika rentang byte telah dipangkas, jika rentang tersebut kemudian dibaca lagi, data yang dikembalikan mungkin merupakan data asli sebelum operasi pemangkasan—semua nol (0x00 byte), semua yang (0xff byte), atau kombinasi dari ini. Sebelum operasi pemangkasan diteruskan ke sistem penyimpanan yang mendasar, rentang input dikurangi agar selaras dengan batas halaman (4.096 byte pada edisi Windows berbasis 32-bit dan x64, 8.192 byte pada edisi Windows Itanium-Based).

Jika terjadi kesalahan saat memproses entri FILE_LEVEL_TRIM_RANGE yang mengikuti struktur FILE_LEVEL_TRIM dalam buffer input yang ditunjukkan oleh parameter lpInBuffer , pemrosesan berhenti dan anggota NumRangesProcessed dari struktur FILE_LEVEL_TRIM_OUTPUT yang ditunjukkan oleh parameter lpOutBuffer akan menunjukkan rentang yang berhasil diproses. Rentang apa pun antara NumRangesProcessed dan anggota NumRanges dari struktur FILE_LEVEL_TRIM tidak diproses.

Kode kontrol FSCTL_FILE_LEVEL_TRIM tidak kompatibel dengan file terenkripsi atau terkompresi (GetFileAttributes mengembalikan FILE_ATTRIBUTE_ENCRYPTED atau FILE_ATTRIBUTE_COMPRESSED) dan akan gagal dengan ERROR_INVALID_PARAMETER. File jarang (ditunjukkan oleh FILE_ATTRIBUTE_SPARSE_FILE) didukung, tetapi hanya rentang yang telah dialokasikan yang dapat dipangkas. File pada volume yang dienkripsi oleh teknologi BitLocker didukung, sementara file yang dienkripsi secara individual tidak.

Kode kontrol FSCTL_FILE_LEVEL_TRIM tidak berpartisipasi dalam transaksi. Jika kode kontrol FSCTL_FILE_LEVEL_TRIM diproses selama transaksi, dan transaksi dibatalkan, pemangkasan tidak akan digulung balik dengan transaksi.

Rentang yang berhasil dipangkas akan dihapus dari cache sistem file.

Rentang yang dipangkas dapat berada di luar panjang data yang valid (VDL) hingga akhir file (EOF).

Di Windows 8 dan Windows Server 2012, kode ini didukung oleh teknologi berikut.

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Ya
SMB 3.0 Transparent Failover (TFO) Ya
SMB 3.0 dengan Scale-out File Shares (SO) Ya
Sistem File Volume Bersama Kluster (CsvFS) Ya
Sistem File Tangguh (ReFS) Tidak

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Header winioctl.h (termasuk Windows.h)

Lihat juga