структура USN_JOURNAL_DATA_V2 (winioctl.h)

  • Статья

Представляет журнал изменений последовательного номера обновления (USN), его записи и емкость. Эта структура является выходным буфером для кода элемента управления FSCTL_QUERY_USN_JOURNAL .

Синтаксис

typedef struct {
  DWORDLONG UsnJournalID;
  USN       FirstUsn;
  USN       NextUsn;
  USN       LowestValidUsn;
  USN       MaxUsn;
  DWORDLONG MaximumSize;
  DWORDLONG AllocationDelta;
  WORD      MinSupportedMajorVersion;
  WORD      MaxSupportedMajorVersion;
  DWORD     Flags;
  DWORDLONG RangeTrackChunkSize;
  LONGLONG  RangeTrackFileSizeThreshold;
} USN_JOURNAL_DATA_V2, *PUSN_JOURNAL_DATA_V2;

Члены

UsnJournalID

Текущий идентификатор журнала. Журналу назначается новый идентификатор при создании, и он может быть помечен новым идентификатором в ходе его существования. Файловая система NTFS использует этот идентификатор для проверка целостности.

FirstUsn

Номер первой записи, которую можно прочитать из журнала.

NextUsn

Номер следующей записи, записываемой в журнал.

LowestValidUsn

Первая запись, записанная в журнал для данного экземпляра журнала. Перечисление файлов или каталогов в томе может возвращать номер USN ниже этого значения (иными словами, значение элемента FirstUsn меньше значения элемента LowerValidUsn ). Если это так, журнал помечен новым идентификатором с момента последнего написания USN. В этом случае Функция LowestValidUsn может указывать на нерегламентированность в журнале, при которой изменения некоторых или всех файлов или каталогов тома, которые не были записаны в журнале изменений.

MaxUsn

Самый большой номер USN, поддерживаемый журналом изменений. Администратор должен удалить журнал изменений, так как значение NextUsn приближается к этому значению.

MaximumSize

Целевой максимальный размер журнала изменений в байтах. Журнал изменений может увеличиться больше этого значения, но затем он усекается в следующей контрольной точке файловой системы NTFS до меньше этого значения.

AllocationDelta

Количество байтов дисковой памяти, добавляемой в конец и удаляемой из начала журнала изменений при каждом выделении или освобождении памяти. Иными словами, выделение и освобождение происходит в единицах такого размера. Целое число, кратное размеру кластера, является разумным значением для этого элемента.

MinSupportedMajorVersion

Минимальная версия журнала изменений USN, которую поддерживает файловая система.

MaxSupportedMajorVersion

Максимальная версия журнала изменений USN, которую поддерживает файловая система.

Flags

Указывает, включено ли отслеживание диапазонов. Ниже приведены возможные значения для элемента Flags .

Значение Значение
0x00000000
 Отслеживание диапазона для тома не включено.
FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE
0x00000001
 Отслеживание диапазона включено для тома.

RangeTrackChunkSize

Степень детализации отслеживаемых диапазонов. Допустимо только в том случае, если для элемента Flags также задано значение FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE.

RangeTrackFileSizeThreshold

Пороговое значение размера файла, чтобы начать отслеживание диапазона для файлов с равным или большим размером. Допустимо только в том случае, если для элемента Flags также задано значение FLAG_USN_TRACK_MODIFIED_RANGES_ENABLE.

Требования

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

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

FSCTL_QUERY_USN_JOURNAL

USN_JOURNAL_DATA_V0

USN_JOURNAL_DATA_V1

Структуры управления томами