Поделиться через

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)

См. также