FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Article

Active la fonctionnalité de suivi des plages pour le flux de journal de modifications du nombre de séquences de mise à jour (USN) sur un volume cible, ou modifie les paramètres de suivi des plages déjà activés.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to volume
  FSCTL_USN_TRACK_MODIFIED_RANGES,  // dwIoControlCode
  (LPDWORD) lpInBuffer,             // input buffer
  (DWORD) nInBufferSize,            // size of input buffer
  (LPDWORD) lpOutBuffer,            // lpOutbuffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

Remarques

Pour connaître les implications des E/S qui se chevauchent sur cette opération, consultez la section Remarques de la rubrique DeviceIoControl .

Vous pouvez utiliser FSCTL_USN_TRACK_MODIFIED_RANGES pour activer le suivi de plage pour la première fois pour un volume. Après l’activation du suivi de plage, l’état et les paramètres sont conservés pour ce volume et, au prochain redémarrage, le suivi de plage est initialisé lu à partir des paramètres persistants.

Vous pouvez également utiliser FSCTL_USN_TRACK_MODIFIED_RANGES pour modifier un paramètre de suivi de la plage de flux de journal des modifications existant. Si le suivi de plage existe déjà, FSCTL_USN_TRACK_MODIFIED_RANGES le définit sur les paramètres fournis dans la structure USN_TRACK_MODIFIED_RANGES . La taille du bloc ou le seuil de taille de fichier ne peuvent être réduits que par rapport aux valeurs précédentes. Une fois activée, la fonctionnalité de suivi des plages ne peut pas être désactivée, sauf si le journal est supprimé.

Pour récupérer un handle dans un volume, appelez CreateFile avec le paramètre lpFileName défini sur une chaîne sous la forme suivante :

\\.\X:

Dans la chaîne précédente, X est la lettre identifiant le lecteur sur lequel le volume apparaît. Le volume doit être NTFS 3.0 ou version ultérieure. Pour obtenir la version NTFS d’un volume, ouvrez une invite de commandes avec des droits d’accès Administrateur et exécutez la commande suivante :

fsutil fsinfo ntfsinfoX:

où X correspond à la lettre de lecteur du volume.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 R2 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi