PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK Rückruffunktion (wdm.h)

Artikel
02/07/2025

Die ClfsAdvanceTailCallback--Funktion wechselt zur Basisprotokollsequenznummer (Base Log Sequence Number, LSN) des Clientprotokolls.

Syntax

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

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

Parameter

[in] LogFile

Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die den CLFS-Protokolldatenstrom darstellt, dessen Tail erweitert werden soll.

[in] TargetLsn

Ein Zeiger auf eine CLFS_LSN-Struktur, die den LSN enthält, den der Client nach oder nach vorn bewegen soll.

[in] ClientData

Ein Zeiger auf vom Client bereitgestellte Informationen. Sie geben diese Daten im AdvanceTailCallbackData Member der CLFS_MGMT_CLIENT_REGISTRATION Struktur an.

Rückgabewert

Die ClfsAdvanceTailCallback--Funktion sollte entweder STATUS_PENDING oder einen Fehlerstatus zurückgeben. Ein Rückgabewert von STATUS_PENDING gibt an, dass die Anforderung zum Verschieben des Protokollschwanzs des Clients asynchron abgeschlossen wird. Die ClfsMgmtAdvanceTailCallback--Funktion darf nicht STATUS_SUCCESS zurückgeben, auch wenn sie synchron abgeschlossen wird.

Bemerkungen

Die ClfsAdvanceTailCallback--Funktion wird aufgerufen, wenn CLFS-Verwaltungsanforderungen anfordert, dass der Client den Protokollschwanz vorausleite.

Die ClfsAdvanceTailCallback--Funktion darf vor der Rückgabe nur eine minimale Verarbeitungsmenge ausführen. Die funktion ClfsAdvanceTailCallback kann z. B. das folgende Verfahren ausführen:

Wenn die Anforderung nicht verarbeitet werden kann, wird ein Fehlerstatus zurückgegeben.
Wenn die Anforderung verarbeitet werden kann, erstellen Sie eine Arbeitsaufgabe, und stellen Sie sie in die Warteschlange, um die Aktionen auszuführen, die erforderlich sind, um den Tail des Clients zu verschieben, und geben Sie dann STATUS_PENDING zurück. Weitere Informationen zum Warteschlangen eines Arbeitsthreads finden Sie unter System Worker Threads.

Wenn ein Client die ClfsMgmtRegisterManagedClient Routine aufruft, um sich bei der CLFS-Verwaltung zu registrieren, stellt der Client sowohl einen Zeiger auf die ClfsAdvanceTailCallback--Funktion und die benutzerdefinierten Daten bereit, die als Parameter an die ClfsAdvanceTailCallback Funktion übergeben werden, wenn diese Funktion aufgerufen wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL-	Bei IRQL-<= APC_LEVEL aufgerufen

Siehe auch

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase-

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure

Freigeben über