ClfsReadRestartArea-Funktion (wdm.h)
Die ClfsReadRestartArea- Routine liest den Neustartdatensatz, der zuletzt in einen angegebenen CLFS-Stream geschrieben wurde.
Syntax
CLFSUSER_API NTSTATUS ClfsReadRestartArea(
[in, out] PVOID pvMarshalContext,
[out] PVOID *ppvRestartBuffer,
[out] PULONG pcbRestartBuffer,
[out] PCLFS_LSN plsn,
[out] PVOID *ppvReadContext
);
Parameter
[in, out] pvMarshalContext
Ein Zeiger auf einen undurchsichtigen Kontext, der einen Marshallingbereich darstellt, der einem CLFS-Stream zugeordnet ist. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateMarshallingAreaabgerufen.
[out] ppvRestartBuffer
Ein Zeiger auf eine Variable, die einen Zeiger auf den Datenpuffer des Neustartdatensatzes empfängt.
[out] pcbRestartBuffer
Ein Zeiger auf eine ULONG-Typvariable, die die Größe des Datenpuffers in Byte empfängt, auf den pcbRestartBufferverweist. Dies ist die Länge des Datenpuffers des Neustartdatensatzes.
[out] plsn
Ein Zeiger auf eine CLFS_LSN Struktur, die den LSN des gelesenen Neustartdatensatzes empfängt.
[out] ppvReadContext
Ein Zeiger auf eine Variable, die einen Zeiger auf einen undurchsichtigen Lesekontext empfängt. Der Aufrufer kann diesen Kontext an ClfsReadPreviousRestartArea oder ClfsReadNextLogRecordübergeben. Wenn der Aufrufer den Lesekontext verwendet hat, muss er den Kontext freigeben, indem er ClfsTerminateReadLogaufruft.
Rückgabewert
ClfsReadRestartArea gibt STATUS_SUCCESS zurück, wenn sie 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.
Informationen zum Lesen von Datensätzen aus CLFS-Streams finden Sie unter Lesen von Datensätzen aus einem CLFS Stream- und Lesen von Neustartdatensätzen aus einem CLFS-Stream-.
Lesekontexte sind nicht threadsicher. Clients sind für die Serialisierung des Zugriffs auf Lesekontexte verantwortlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h) |
| Library | Clfs.lib |
| DLL- | Clfs.sys |
| IRQL- | <= APC_LEVEL |