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, откройте командную строку с правами администратора и выполните следующую команду (где X — буква диска тома): fsutil fsinfo ntfsinfo X:

Irp-IoStatus.Status> имеет значение STATUS_SUCCESS, если запрос выполнен успешно. В противном случае для состояния задано соответствующее условие ошибки в виде кода NTSTATUS. Дополнительные сведения см. в разделе "Значения NTSTATUS".

Требования

См. также

• DeviceIoControl