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 |