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