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

Статья
02/27/2024

Подпрограмма 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.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h)
Библиотека	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

См. также раздел

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea