ClfsFlushToLsn-Funktion (wdm.h)

Die ClfsFlushToLsn-Routine erzwingt alle Datensätze, deren LSN kleiner oder gleich einer angegebenen LSN ist, zu stabilem Speicher.

Syntax

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

Parameter

[in] pvMarshalContext

Ein Zeiger auf einen undurchsichtigen Kontext, der einem Marshallingbereich zugeordnet ist. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen von ClfsCreateMarshallingArea abgerufen.

[in] plsnFlush

Ein Zeiger auf eine CLFS_LSN-Struktur . Alle Datensätze, die eine LSN kleiner oder gleich plsnFlush haben, werden garantiert zu stabilem Speicher gezwungen. Wenn plsnFlush gleich CLFS_LSN_NULL ist, werden alle Datensätze im Marshallingbereich zur stabilen Speicherung gezwungen.

[out, optional] plsnLastFlushed

Ein Zeiger auf eine CLFS_LSN-Struktur , die die LSN des ältesten Datensatzes empfängt, der nicht geleert wurde. Dies ist die LSN des Datensatzes unmittelbar nach dem letzten geleerten Datensatz.

Bei erfolgreicher Rückgabe ist plsnLastFlushed größer als der in plsnFlush angegebene Wert. PlsnLastFlushed verweist jedoch nicht unbedingt auf einen Datensatz im Stream. Wenn beispielsweise alle Datensätze im Stream geleert wurden, ist plsnLastFlushed die LSN, die dem nächsten Datensatz zugewiesen wird, der in den Stream geschrieben wird.

Rückgabewert

ClfsFlushToLsn gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System( Common Log File System).

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wdm.h (wdm.h einschließen)
Bibliothek	Clfs.lib
DLL	Clfs.sys
IRQL	IRQL <= APC_LEVEL

Weitere Informationen

ClfsFlushBuffers