FSCTL_LOOKUP_STREAM_FROM_CLUSTER IOCTL (winioctl.h)

  • Article

Avec un descripteur pour un volume NTFS ou un fichier sur un volume NTFS, retourne une chaîne de structures de données qui décrit les flux qui occupent les clusters spécifiés.

Important

FSCTL_LOOKUP_STREAM_FROM_CLUSTER est une opération très gourmande en ressources et utilise généralement une très grande quantité de bande passante disque, de mémoire et de temps. Il est peu probable que la plupart de ces informations restent dans le cache, de sorte qu’un deuxième appel à FSCTL_LOOKUP_STREAM_FROM_CLUSTER prendra presque autant de temps que le premier appel. Pour effectuer plusieurs recherches, il est plus efficace d’utiliser FSCTL_ENUM_USN_DATA pour énumérer chaque enregistrement MFT, puis d’utiliser FSCTL_GET_RETRIEVAL_POINTERS pour collecter les données à mapper entre les clusters et les flux.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Remarques

Dans Windows 8 et Windows Server 2012, ce code est pris en charge par les technologies suivantes.

Technologie Prise en charge
Protocole Server Message Block (SMB) 3.0 No
Basculement transparent SMB 3.0 (TFO) No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) No
Système de fichiers du volume partagé de cluster (CsvFS) Oui

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi