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 von ClfsCreateMarshallingArea abgerufen.
[out] ppvRestartBuffer
Ein Zeiger auf eine Variable, die einen Zeiger auf den Datenpuffer des Neustartdatensatzes empfängt.
[out] pcbRestartBuffer
Ein Zeiger auf eine Variable vom Typ ULONG, die die Größe des Datenpuffers in Bytes empfängt, auf den von pcbRestartBuffer verwiesen wird. Dies ist die Länge des Datenpuffers des Neustartdatensatzes.
[out] plsn
Ein Zeiger auf eine CLFS_LSN-Struktur, die die 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 die Verwendung des Lesekontexts abgeschlossen hat, muss er den Kontext durch Aufrufen von ClfsTerminateReadLog freigeben.
Rückgabewert
ClfsReadRestartArea 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).
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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | wdm.h (wdm.h einschließen) |
| Bibliothek | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |