Функция ClfsReadRestartArea (wdm.h)
Программа ClfsReadRestartArea считывает запись перезапуска, которая была недавно записана в указанный поток CLFS.
Синтаксис
CLFSUSER_API NTSTATUS ClfsReadRestartArea(
[in, out] PVOID pvMarshalContext,
[out] PVOID *ppvRestartBuffer,
[out] PULONG pcbRestartBuffer,
[out] PCLFS_LSN plsn,
[out] PVOID *ppvReadContext
);
Параметры
[in, out] pvMarshalContext
Указатель на непрозрачный контекст, представляющий область маршаллинга, связанную с потоком CLFS. Вызывающий объект ранее получил этот указатель путем вызова ClfsCreateMarshallingArea.
[out] ppvRestartBuffer
Указатель на переменную, которая получает указатель на буфер данных записи перезапуска.
[out] pcbRestartBuffer
Указатель на переменную типа ULONG, которая получает размер в байтах буфера данных, на который указывает pcbRestartBuffer. Это длина буфера данных записи перезапуска.
[out] plsn
Указатель на структуру CLFS_LSN, которая получает LSN записи перезапуска, считываемой.
[out] ppvReadContext
Указатель на переменную, которая получает указатель на непрозрачный контекст чтения. Вызывающий объект может передать этот контекст в ClfsReadPreviousRestartArea или ClfsReadNextLogRecord. Когда вызывающий объект завершит работу с контекстом чтения, он должен освободить контекст, вызвав ClfsTerminateReadLog.
Возвращаемое значение
ClfsReadRestartArea возвращает STATUS_SUCCESS, если оно успешно; в противном случае возвращается один из кодов ошибок, определенных в Ntstatus.h.
Замечания
Описание концепций и терминологии CLFS см. в common Log File System.
Сведения о чтении записей из потоков CLFS см. в чтении записей данных из потока CLFS и чтении записей перезапуска изпотока CLFS.
Контексты чтения не являются потокобезопасными. Клиенты отвечают за сериализацию доступа к контекстам чтения.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows. |
| целевая платформа | Настольный |
| заголовка | wdm.h (include Wdm.h) |
| библиотеки | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |