PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK fungsi panggilan balik (wdm.h)

  • Artikel

Fungsi ClfsAdvanceTailCallback memajukan nomor urutan log dasar (LSN) dari log klien.

Sintaks

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

NTSTATUS PclfsClientAdvanceTailCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] PCLFS_LSN TargetLsn,
  [in] PVOID ClientData
)
{...}

Parameter

[in] LogFile

Penunjuk ke struktur LOG_FILE_OBJECT yang mewakili aliran log CLFS yang ekornya harus ditingkatkan.

[in] TargetLsn

Penunjuk ke struktur CLFS_LSN yang berisi LSN tempat klien harus memajukan ekornya ke atau di luarnya.

[in] ClientData

Penunjuk ke informasi yang disediakan klien. Anda menentukan data ini di anggota AdvanceTailCallbackData dari struktur CLFS_MGMT_CLIENT_REGISTRATION .

Nilai kembali

Fungsi ClfsAdvanceTailCallback harus mengembalikan STATUS_PENDING atau status kesalahan. Nilai pengembalian STATUS_PENDING menunjukkan bahwa permintaan untuk memindahkan ekor log klien akan diselesaikan secara asinkron. Fungsi ClfsMgmtAdvanceTailCallback tidak boleh mengembalikan STATUS_SUCCESS, meskipun selesai secara sinkron.

Keterangan

Fungsi ClfsAdvanceTailCallback dipanggil ketika manajemen CLFS meminta agar klien memajukan ekor lognya.

Fungsi ClfsAdvanceTailCallback hanya boleh melakukan pemrosesan dalam jumlah minimal sebelum kembali. Misalnya, fungsi ClfsAdvanceTailCallback mungkin mengikuti prosedur ini:

  1. Jika permintaan tidak dapat diproses, kembalikan status kesalahan.
  2. Jika permintaan dapat diproses, buat dan antrekan item kerja untuk melakukan tindakan yang diperlukan untuk memindahkan ekor klien, lalu kembali STATUS_PENDING. Untuk informasi selengkapnya tentang mengantre utas pekerja, lihat Utas Pekerja Sistem.
Ketika klien memanggil rutinitas ClfsMgmtRegisterManagedClient untuk mendaftar dengan manajemen CLFS, klien menyediakan penunjuk ke fungsi ClfsAdvanceTailCallback dan data kustom yang akan diteruskan sebagai parameter ke fungsi ClfsAdvanceTailCallback ketika fungsi ini dipanggil.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di Windows Server 2003 R2, Windows Vista, dan versi Windows yang lebih baru.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL Dipanggil di IRQL <= APC_LEVEL

Lihat juga

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure