Функция 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 |