Функция 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 см. в разделах Чтение записей данных из Stream CLFS и Чтение записей перезапуска из Stream CLFS.

Контексты чтения не являются потокобезопасны. Клиенты отвечают за сериализацию доступа к контекстам чтения.

Требования

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

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

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog