PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK fungsi panggilan balik (wdm.h)

  • Artikel

Fungsi ClfsLogGrowthCompleteCallback mengimplementasikan tindakan yang akan diambil klien ketika ruang dibebaskan dalam log yang sebelumnya telah penuh.

Sintaks

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

void PclfsClientLffHandlerCompleteCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] NTSTATUS OperationStatus,
  [in] BOOLEAN LogIsPinned,
  [in] PVOID ClientData
)
{...}

Parameter

[in] LogFile

Penunjuk ke struktur LOG_FILE_OBJECT yang mewakili aliran log CLFS yang lognya telah selesai tumbuh.

[in] OperationStatus

Status permintaan klien sebelumnya untuk menangani kondisi penuh file log. Ini akan menjadi STATUS_SUCCESS atau status kesalahan yang menunjukkan alasan permintaan tidak berhasil diselesaikan.

[in] LogIsPinned

Jika TRUE, menentukan bahwa ekor log saat ini disematkan; FALSE jika ekor log tidak disematkan.

[in] ClientData

Penunjuk ke informasi yang disediakan klien.

Nilai kembali

Tidak ada

Keterangan

Karena panggilan ke ClfsMgmtHandleLogFileFull selesai secara asinkron, tindakan apa pun yang akan dilakukan klien ketika kondisi penuh file log telah ditangani termasuk dalam fungsi ClfsLogGrowthCompleteCallback .

Jika panggilan ke rutinitas ClfsMgmtHandleLogFileFull yang dikembalikan mengembalikan STATUS_PENDING, maka fungsi ClfsLogGrowthCompleteCallback akan dipanggil ketika operasi selesai. Jika status yang berbeda dikembalikan, maka fungsi ClfsLogGrowthCompleteCallback tidak akan dipanggil.

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

  1. Jika nilai parameter OperationStatus adalah status kesalahan, kembalikan.
  2. Jika nilai parameter OperationStatus STATUS_SUCCESS, buat dan antrekan item kerja untuk memberi tahu klien bahwa ia dapat melanjutkan pemrosesan.
Ketika klien menggunakan rutinitas ClfsMgmtRegisterManagedClient untuk mendaftar dengan manajemen CLFS, klien menyediakan penunjuk ke fungsi ClfsLogGrowthCompleteCallback dan data kustom yang akan diteruskan sebagai parameter ke fungsi ClfsLogGrowthCompleteCallback 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

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient