Fungsi ClfsReadNextLogRecord (wdm.h)

  • Artikel

Rutinitas ClfsReadNextLogRecord membaca rekaman berikutnya secara berurutan, relatif terhadap rekaman saat ini dalam konteks baca.

Sintaks

CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
  [in, out]      PVOID             pvReadContext,
  [out]          PVOID             *ppvBuffer,
  [out]          PULONG            pcbBuffer,
  [in, out]      PCLFS_RECORD_TYPE peRecordType,
  [in, optional] PCLFS_LSN         plsnUser,
  [out]          PCLFS_LSN         plsnUndoNext,
  [out]          PCLFS_LSN         plsnPrevious,
  [out]          PCLFS_LSN         plsnRecord
);

Parameter

[in, out] pvReadContext

Penunjuk ke konteks baca yang sebelumnya diperoleh pemanggil dengan memanggil ClfsReadLogRecord atau ClfsReadRestartArea.

[out] ppvBuffer

Penunjuk ke variabel yang menerima penunjuk ke buffer yang berisi data rekaman.

[out] pcbBuffer

Penunjuk ke variabel berjenis ULONG yang menerima ukuran, dalam byte, dari buffer yang ditujukkan oleh *ppvBuffer. Ini adalah panjang buffer data dari rekaman yang dibaca.

[in, out] peRecordType

Penunjuk ke variabel jenis CLFS_RECORD_TYPE. Pemanggil harus mengatur parameter ini ke salah satu nilai berikut.

Nilai Rekaman yang akan dibaca
ClfsDataRecord Rekaman data berikutnya.
ClfsRestartRecord Rekaman hidupkan ulang berikutnya.
ClfsClientRecord Rekaman berikutnya yang merupakan rekaman data atau rekaman hidupkan ulang.

[in, optional] plsnUser

Penunjuk ke struktur CLFS_LSN yang memasok LSN rekaman yang akan dibaca. Rekaman yang ditentukan dibaca alih-alih rekaman yang akan dibaca sesuai dengan mode (ClfsContextUndoNext, ClfsContextPrevious, atau ClfsContextForward) dari konteks baca (pvReadContext). LSN yang disediakan dalam plsnUser harus kurang dari LSN saat ini dari konteks baca. Parameter ini bisa NULL.

[out] plsnUndoNext

Penunjuk ke struktur CLFS_LSN yang menerima LSN berikutnya dari rekaman yang dibaca.

[out] plsnPrevious

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

[out] plsnRecord

Penunjuk ke struktur CLFS_LSN yang menerima LSN rekaman yang dibaca.

Nilai kembali

ClfsReadNextLogRecord 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

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea