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

Статья
03/08/2023

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

Требования

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

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

ClfsFlushBuffers