FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)
FSCTL_QUERY_FILE_REGIONS meminta daftar wilayah file, berdasarkan parameter penggunaan tertentu, untuk file yang terkait dengan handel tempat FSCTL ini dipanggil. Pesan ini berisi elemen data FILE_REGION_INPUT opsional. Jika tidak ada parameter FILE_REGION_INPUT yang ditentukan, informasi untuk seluruh ukuran file dikembalikan.
Kode utama
FSCTL_QUERY_FILE_REGIONS
Buffer input
Penunjuk ke struktur FILE_REGION_INPUT yang menunjukkan wilayah file yang akan dikueri.
Panjang buffer input
Ukuran struktur FILE_REGION_INPUT yang dirujuk InputBuffer , dalam byte.
Buffer output
Penunjuk ke struktur FILE_REGION_OUTPUT di mana hasil kueri dikembalikan.
Panjang buffer output
Ukuran buffer yang dirujuk OutputBuffer , dalam byte.
Buffer Input/Output
n/a
Panjang buffer Input/Output
n/a
Blok status
Dicadangkan untuk penggunaan sistem.
Keterangan
Untuk melakukan operasi ini, panggil FltFsControlFile atau ZwFsControlFile dengan parameter berikut.
| Parameter | Deskripsi |
|---|---|
| Instans | [in] Hanya untuk FltFsControlFile . Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL. |
| FileObject | [in] Hanya untuk FltFsControlFile . Penunjuk objek file untuk file atau direktori yang merupakan target permintaan ini. Parameter ini diperlukan dan tidak boleh NULL. |
| FileHandle | [in] Hanya untuk ZwFsControlFile . Handel file dari file atau direktori yang merupakan target permintaan ini. Parameter ini diperlukan dan tidak boleh NULL. |
| IoStatusBlock | [keluar] Hanya untuk ZwFsControlFile . Penunjuk ke struktur IO_STATUS_BLOCK tempat status akhir permintaan dikembalikan. |
| FsControlCode | [in] Atur ke FSCTL_QUERY_FILE_REGIONS. |
| InputBuffer | [in/opsional] Penunjuk ke struktur FILE_REGION_INPUT yang menunjukkan wilayah file yang akan dikueri. |
| InputBufferLength | [in] Ukuran buffer yang dirujuk InputBuffer , dalam byte. |
| OutputBuffer | [keluar] Penunjuk ke struktur FILE_REGION_OUTPUT di mana hasil kueri dikembalikan. |
| OutputBufferLength | [keluar] Ukuran buffer yang dirujuk OutputBuffer , dalam byte. |
| PanjangDireturned | [keluar] Penunjuk ke variabel yang dialokasikan penelepon yang menerima ukuran dalam byte informasi yang dikembalikan dalam buffer di OutputBuffer. |
Mengembalikan nilai
FSCTL_QUERY_FILE_REGIONS mengembalikan STATUS_SUCCESS setelah berhasil diselesaikan; jika tidak, kode kesalahan akan dikembalikan. Setelah berhasil diselesaikan, pemanggil harus terlebih dahulu memverifikasi bahwa IoStatus.Information lebih besar dari atau sama dengan LengthReturned sebelum mengakses informasi yang dikembalikan di OutputBuffer.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 |
| Header | ntifs.h |