Fungsi ClfsReadRestartArea (wdm.h)

Rutinitas ClfsReadRestartArea membaca catatan hidupkan ulang yang baru-baru ini ditulis ke aliran CLFS tertentu.

Sintaks

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

Penunjuk ke konteks buram yang mewakili area marshalling yang terkait dengan aliran CLFS. Penelepon sebelumnya mendapatkan pointer ini dengan memanggil ClfsCreateMarshallingArea.

[out] ppvRestartBuffer

Penunjuk ke variabel yang menerima penunjuk ke buffer data rekaman hidupkan ulang.

[out] pcbRestartBuffer

Penunjuk ke variabel berjenis ULONG yang menerima ukuran, dalam byte, dari buffer data yang diacu oleh pcbRestartBuffer. Ini adalah panjang buffer data dari rekaman hidupkan ulang.

[out] plsn

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

[out] ppvReadContext

Penunjuk ke variabel yang menerima penunjuk ke konteks baca buram. Pemanggil dapat meneruskan konteks ini ke ClfsReadPreviousRestartArea atau ClfsReadNextLogRecord. Ketika pemanggil telah selesai menggunakan konteks baca, pemanggil harus membebaskan konteks dengan memanggil ClfsTerminateReadLog.

Nilai kembali

ClfsReadRestartArea mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Untuk penjelasan tentang konsep dan terminologi CLFS, lihat Sistem File Log Umum.

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

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

Persyaratan

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

Lihat juga

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog