FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)

  • Статья

Включает функцию отслеживания диапазона для потока журнала изменений номера последовательности обновления (USN) на целевом томе или изменяет уже включенные параметры отслеживания диапазона.

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

Комментарии

Сведения о последствиях перекрывающихся операций ввода-вывода для этой операции см. в разделе Примечания статьи DeviceIoControl .

Вы можете использовать FSCTL_USN_TRACK_MODIFIED_RANGES , чтобы включить отслеживание диапазона в первый раз для тома. После включения отслеживания диапазона состояние и параметры будут сохранены для этого тома, а при следующей перезагрузке отслеживание диапазона будет инициализировано считывать из сохраненных параметров.

Вы также можете использовать FSCTL_USN_TRACK_MODIFIED_RANGES для изменения существующего параметра отслеживания диапазона потока изменений журнала. Если отслеживание диапазона уже существует, FSCTL_USN_TRACK_MODIFIED_RANGES задает для него параметры, указанные в структуре USN_TRACK_MODIFIED_RANGES . Пороговое значение размера блока или файла можно уменьшить только по сравнению с предыдущими значениями. После включения функцию отслеживания диапазонов нельзя отключить, если журнал не будет удален.

Чтобы получить дескриптор тома, вызовите CreateFile с параметром lpFileName , для которого задана строка в следующей форме:

\\.\X:

В предыдущей строке X — это буква, обозначающая диск, на котором отображается том. Том должен быть NTFS 3.0 или более поздней версии. Чтобы получить версию NTFS тома, откройте командную строку с правами доступа администратора и выполните следующую команду:

fsutil fsinfo ntfsinfoX:

где X — буква диска тома.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 [только классические приложения]
Минимальная версия сервера Windows Server 2012 R2 [только классические приложения]
Верхняя часть winioctl.h (включая Windows.h)

См. также раздел