FSCTL_LOOKUP_STREAM_FROM_CLUSTER IOCTL (winioctl.h)
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) |