Bagikan melalui

FSCTL_LOOKUP_STREAM_FROM_CLUSTER IOCTL (winioctl.h)

  • Artikel

Mengingat handel ke volume NTFS atau file pada volume NTFS, mengembalikan rantai struktur data yang menjelaskan aliran yang menempati kluster yang ditentukan.

Penting

FSCTL_LOOKUP_STREAM_FROM_CLUSTER adalah operasi yang sangat intensif sumber daya, dan biasanya menggunakan bandwidth, memori, dan waktu disk dalam jumlah yang sangat besar. Tidak mungkin bahwa banyak informasi ini akan tetap berada di cache sehingga panggilan kedua ke FSCTL_LOOKUP_STREAM_FROM_CLUSTER akan memakan waktu hampir sebanyak panggilan pertama. Untuk melakukan beberapa pencarian, lebih efisien menggunakan FSCTL_ENUM_USN_DATA untuk menghitung setiap catatan MFT lalu menggunakan FSCTL_GET_RETRIEVAL_POINTERS untuk mengumpulkan data untuk memetakan antara kluster dan aliran.

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

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

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

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Header winioctl.h (termasuk Windows.h)

Lihat juga