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


Функция 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 см. в чтении записей данных из потока CLFS и чтении записей перезапуска изпотока CLFS.

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

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
целевая платформа Настольный
заголовка wdm.h (include Wdm.h)
библиотеки Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

См. также

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea