Bagikan melalui

FSCTL_GET_RETRIEVAL_POINTERS IOCTL (winioctl.h)

  • Artikel

Mengingat handel file, mengambil struktur data yang menjelaskan alokasi dan lokasi pada disk file tertentu, atau, mengingat handel volume, lokasi kluster buruk pada volume.

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

DeviceIoControl(
  (HANDLE) hDevice,                 // handle to file, directory, or volume
  FSCTL_GET_RETRIEVAL_POINTERS,     // 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

Operasi FSCTL_GET_RETRIEVAL_POINTERS mengambil struktur data berukuran bervariasi yang menjelaskan alokasi dan lokasi pada disk file tertentu. Struktur menjelaskan pemetaan antara nomor kluster virtual (offset VCN dalam file atau ruang aliran) dan nomor kluster logis (offset LCN dalam ruang volume).

Kode kontrol FSCTL_GET_RETRIEVAL_POINTERS didukung untuk operasi file atau direktori pada sistem file NTFS, FAT, exFAT, UDF, dan ReFS.

Pada sistem file yang didukung, operasi FSCTL_GET_RETRIEVAL_POINTERS mengembalikan lokasi luas data yang tidak dikenal. Data penduduk tidak pernah memiliki lokasi yang luas.

Kode kontrol FSCTL_GET_RETRIEVAL_POINTERS juga mendukung fungsionalitas alternatif untuk menemukan kluster yang buruk. Untuk mengkueri lokasi kluster buruk pada volume yang diformat dengan NTFS, FAT, atau exFAT, gunakan handel volume sebagai parameter hDevice . Fungsionalitas ini hanya didukung pada NTFS, FAT, dan exFAT, dan pemanggil harus memiliki izin MANAGE_VOLUME_ACCESS ke volume.

Untuk implikasi I/O yang tumpang tindih pada operasi ini, lihat bagian Keterangan dari topik DeviceIoControl .

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

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

Persyaratan

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

Lihat juga