Функция ClfsReadNextLogRecord (wdm.h)
Подпрограмма 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 см. в разделах Чтение записей данных из Stream CLFS и Чтение записей перезапуска из Stream CLFS.
Контексты чтения не являются потокобезопасны. Клиенты отвечают за сериализацию доступа к контекстам чтения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wdm.h (включая Wdm.h) |
| Библиотека | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |