FSCTL_LOOKUP_STREAM_FROM_CLUSTER IOCTL (winioctl.h)

  • Articolo

Dato un handle a un volume NTFS o a un file in un volume NTFS, restituisce una catena di strutture di dati che descrive i flussi che occupano i cluster specificati.

Importante

FSCTL_LOOKUP_STREAM_FROM_CLUSTER è un'operazione a elevato utilizzo di risorse e in genere usa una quantità molto elevata di larghezza di banda del disco, memoria e tempo. È improbabile che molte di queste informazioni rimangano nella cache, quindi una seconda chiamata a FSCTL_LOOKUP_STREAM_FROM_CLUSTER richiederebbe quasi il tempo della prima chiamata. Per eseguire più ricerche, è più efficiente usare FSCTL_ENUM_USN_DATA per enumerare ogni record MFT e quindi usare FSCTL_GET_RETRIEVAL_POINTERS per raccogliere i dati per eseguire il mapping tra cluster e flussi.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

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
);

Commenti

In Windows 8 e Windows Server 2012 questo codice è supportato dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 No
Failover trasparente SMB 3.0 (TFO) No
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO) No
File system del volume condiviso cluster (CsvFS) Sì

Requisiti

   
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Intestazione winioctl.h (include Windows.h)

Vedi anche