Fungsi ClfsReadPreviousRestartArea (wdm.h)

Artikel
07/02/2025

Rutinitas ClfsReadPreviousRestartArea membaca catatan mulai ulang sebelumnya relatif terhadap rekaman saat ini dalam konteks baca.

Sintaksis

C++

CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
  [in]  PVOID     pvReadContext,
  [out] PVOID     *ppvRestartBuffer,
  [out] PULONG    pcbRestartBuffer,
  [out] PCLFS_LSN plsnRestart
);

Parameter

[in] pvReadContext

Penunjuk ke konteks baca yang diperoleh oleh panggilan sebelumnya ke ClfsReadRestartArea.

[out] ppvRestartBuffer

Penunjuk ke variabel yang menerima penunjuk ke buffer data dari rekaman mulai ulang yang dibaca.

[out] pcbRestartBuffer

Penunjuk ke variabel yang diketik ULONG yang menerima ukuran, dalam byte, dari buffer yang ditujukkan oleh *ppvRestartBuffer. Ini adalah panjang buffer data dari rekaman hidupkan ulang yang dibaca.

[out] plsnRestart

Penunjuk ke struktur CLFS_LSN yang menerima LSN sebelumnya dari rekaman hidupkan ulang yang dibaca.

Mengembalikan nilai

ClfsReadPreviousRestartArea mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h. Jika tidak ada area hidupkan ulang sebelumnya, nilai yang dikembalikan adalah STATUS_LOG_START_OF_LOG.

Komentar

Untuk penjelasan tentang konsep dan terminologi CLFS, lihat Common Log File System.

Untuk informasi tentang membaca rekaman dari aliran CLFS, lihat Membaca Rekaman Data dari Aliran CLFS dan Membaca Rekaman Hidupkan Ulang dari aliran CLFS.

Konteks baca tidak aman untuk utas. Klien bertanggung jawab untuk menserialisasikan akses ke konteks baca.

Klien menambahkan rekaman hidupkan ulang ke log CLFS dengan memanggil ClfsWriteRestartArea.

Dengan rutinitas ReadPreviousLogRestartArea, klien dapat menerapkan bentuk titik pemeriksaan fuzzy. Misalnya, status titik pemeriksaan dapat terdiri dari catatan log yang dibatasi oleh dua atau beberapa rekaman mulai ulang.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Tersedia di Windows Server 2003 R2, Windows Vista, dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	wdm.h (termasuk Wdm.h)
Pustaka	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Lihat juga

CLFS_LSN

clfsReadRestartArea

clfsWriteRestartArea

Bagikan melalui