Partager via

FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Article

Active la fonctionnalité de suivi des plages pour le flux de journal des modifications de numéro de séquence de mise à jour (USN) sur un volume cible ou modifie les paramètres de suivi de plage 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 superposées sur cette opération, consultez la section Remarques de la rubrique DeviceIoControl .

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

Vous pouvez également utiliser FSCTL_USN_TRACK_MODIFIED_RANGES pour modifier un paramètre de suivi de plage de flux de journal de modification 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 de bloc ou le seuil de taille de fichier ne peuvent être réduits que des 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 vers 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 les droits d’accès administrateur et exécutez la commande suivante :

fsutil fsinfo ntfsinfoX:

où X est la lettre de lecteur du volume.

Exigences

Exigence Valeur
client minimum pris en charge Windows 8.1 [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2012 R2 [applications de bureau uniquement]
d’en-tête winioctl.h (include Windows.h)

Voir aussi