Функция 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 |