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

Статья
02/07/2025

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

Синтаксис

CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
  [in, out]      PVOID             pvReadContext,
  [out]          PVOID             *ppvBuffer,
  [out]          PULONG            pcbBuffer,
  [in, out]      PCLFS_RECORD_TYPE peRecordType,
  [in, optional] PCLFS_LSN         plsnUser,
  [out]          PCLFS_LSN         plsnUndoNext,
  [out]          PCLFS_LSN         plsnPrevious,
  [out]          PCLFS_LSN         plsnRecord
);

Параметры

[in, out] pvReadContext

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

[out] ppvBuffer

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

[out] pcbBuffer

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

[in, out] peRecordType

Указатель на переменную типа CLFS_RECORD_TYPE. Вызывающий объект должен задать для этого параметра одно из следующих значений.

Ценность	Запись, считываемая
ClfsDataRecord	Следующая запись данных.
ClfsRestartRecord	Следующая запись перезапуска.
ClfsClientRecord	Следующая запись, которая является записью данных или записью перезапуска.

[in, optional] plsnUser

Указатель на структуру CLFS_LSN, которая предоставляет LSN записи для чтения. Указанная запись считывается вместо записи, которая была бы прочитана в соответствии с режимом (ClfsContextUndoNext, ClfsContextPreviousили ClfsContextForward) контекста чтения (pvReadContext). LSN, предоставленный в plsnUser, должен быть меньше текущего LSN контекста чтения. Этот параметр может быть NULL.

[out] plsnUndoNext

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

[out] plsnPrevious

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

[out] plsnRecord

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

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

ClfsReadNextLogRecord возвращает 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

См. также

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea

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