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


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

Подпрограмма ClfsFlushToLsn обеспечивает стабильное хранение всех записей, имеющих номер LSN меньше или равен указанному номеру LSN.

Синтаксис

CLFSUSER_API NTSTATUS ClfsFlushToLsn(
  [in]            PVOID     pvMarshalContext,
  [in]            PCLFS_LSN plsnFlush,
  [out, optional] PCLFS_LSN plsnLastFlushed
);

Параметры

[in] pvMarshalContext

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

[in] plsnFlush

Указатель на структуру CLFS_LSN . Все записи с номером LSN, который меньше или равен plsnFlush , гарантированно будут иметь стабильное хранение. Если plsnFlush равно CLFS_LSN_NULL, то все записи в области маршалинга принудительно сохраняются в стабильном хранилище.

[out, optional] plsnLastFlushed

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

При успешном возврате plsnLastFlushed больше значения, предоставленного в plsnFlush. Однако plsnLastFlushed не обязательно указывает на запись в потоке. Например, если все записи в потоке были записаны, plsnLastFlushed — это номер LSN, который будет назначен следующей записи, записанной в поток.

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

ClfsFlushToLsn возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Комментарии

Описание концепций и терминологии CLFS см. в разделе Common Log File System.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть wdm.h (включая Wdm.h)
Библиотека Clfs.lib
DLL Clfs.sys
IRQL IRQL <= APC_LEVEL

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

ClfsFlushBuffers