ClfsFlushToLsn-Funktion (wdm.h)
Die ClfsFlushToLsn Routinekräfte, um den stabilen Speicher zu aktivieren, alle Datensätze, die einen LSN kleiner oder gleich einem angegebenen LSN aufweisen.
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 Marshalling-Bereich zugeordnet ist. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateMarshallingAreaabgerufen.
[in] plsnFlush
Ein Zeiger auf eine CLFS_LSN Struktur. Alle Datensätze, die einen LSN kleiner oder gleich plsnFlush haben, werden garantiert zu stabilen Speicher gezwungen. Wenn plsnFlush- gleich CLFS_LSN_NULL ist, werden alle Datensätze im Marshalling-Bereich gezwungen, eine stabile Speicherung zu erstellen.
[out, optional] plsnLastFlushed
Ein Zeiger auf eine CLFS_LSN-Struktur, die den LSN des ältesten Datensatzes empfängt, der nicht geleert wurde. Dies ist der LSN des Datensatzes unmittelbar nach dem letzten leeren Datensatz.
Bei erfolgreicher Rückgabe ist plsnLastFlushed größer als der in plsnFlushangegebene Wert. plsnLastFlushed verweist jedoch nicht unbedingt auf einen Datensatz im Datenstrom. Wenn beispielsweise alle Datensätze im Datenstrom geleert wurden, plsnLastFlushed ist der LSN, der dem nächsten Datensatz zugewiesen wird, der in den Datenstrom geschrieben wird.
Rückgabewert
ClfsFlushToLsn gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h) |
| Library | Clfs.lib |
| DLL- | Clfs.sys |
| IRQL- | IRQL-<= APC_LEVEL |