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

Функция ClfsReadPreviousRestartArea (wdm.h)

  • Статья

Подпрограмма ClfsReadPreviousRestartArea считывает предыдущую запись перезапуска относительно текущей записи в контексте чтения.

Синтаксис

CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
  [in]  PVOID     pvReadContext,
  [out] PVOID     *ppvRestartBuffer,
  [out] PULONG    pcbRestartBuffer,
  [out] PCLFS_LSN plsnRestart
);

Параметры

[in] pvReadContext

Указатель на контекст чтения, полученный при предыдущем вызове ClfsReadRestartArea.

[out] ppvRestartBuffer

Указатель на переменную, получающую указатель на буфер данных записи перезапуска, которая считывается.

[out] pcbRestartBuffer

Указатель на переменную типа ULONG, которая получает размер буфера в байтах, на который указывает *ppvRestartBuffer. Это длина буфера данных считываемой записи перезапуска.

[out] plsnRestart

Указатель на структуру CLFS_LSN , получающую предыдущий номер LSN считываемой записи перезапуска.

Возвращаемое значение

ClfsReadPreviousRestartArea возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в ntstatus.h. Если предыдущие области перезапуска отсутствуют, возвращаемое значение будет STATUS_LOG_START_OF_LOG.

Комментарии

Описание концепций и терминологии CLFS см. в разделе Common Log File System.

Сведения о чтении записей из потоков CLFS см. в разделах Чтение записей данных из Stream CLFS и Чтение записей перезапуска из Stream CLFS.

Контексты чтения не являются потокобезопасны. Клиенты отвечают за сериализацию доступа к контекстам чтения.

Клиенты добавляют записи перезапуска в журнал CLFS, вызывая ClfsWriteRestartArea.

С помощью процедуры ReadPreviousLogRestartArea клиенты могут реализовать форму нечетких контрольных точек. Например, состояние контрольной точки может состоять из записей журнала, разделенных двумя или более записями перезапуска.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть wdm.h (включая Wdm.h)
Библиотека Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

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

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea