FSCTL_LOOKUP_STREAM_FROM_CLUSTER IOCTL (winioctl.h)

  • Artículo

Dado un identificador a un volumen NTFS o a un archivo en un volumen NTFS, devuelve una cadena de estructuras de datos que describe los flujos que ocupan los clústeres especificados.

Importante

FSCTL_LOOKUP_STREAM_FROM_CLUSTER es una operación muy intensiva en recursos y normalmente usa una gran cantidad de ancho de banda de disco, memoria y tiempo. Es poco probable que gran parte de esta información permanezca en caché, por lo que una segunda llamada a FSCTL_LOOKUP_STREAM_FROM_CLUSTER tardaría casi tanto tiempo como la primera llamada. Para realizar varias búsquedas, es más eficaz usar FSCTL_ENUM_USN_DATA para enumerar cada registro de MFT y, a continuación, usar FSCTL_GET_RETRIEVAL_POINTERS para recopilar los datos para asignar entre clústeres y flujos.

Para realizar esta operación, llame a la función DeviceIoControl con los siguientes parámetros.

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

Comentarios

En Windows 8 y Windows Server 2012, este código es compatible con las siguientes tecnologías.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) Sí

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluya Windows.h)

Consulte también