PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK Rückruffunktion (wdm.h)

Artikel
02/27/2024

Die ClfsAdvanceTailCallback-Funktion erweitert die 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 die LSN enthält, zu der der Client sein Tail auf oder darüber hinaus ausführen 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 Fehler status zurückgeben. Der Rückgabewert STATUS_PENDING gibt an, dass die Anforderung zum Verschieben des Protokollfragts des Clients asynchron abgeschlossen wird. Die ClfsMgmtAdvanceTailCallback-Funktion darf nicht STATUS_SUCCESS zurückgeben, auch wenn sie synchron abgeschlossen wird.

Hinweise

Die ClfsAdvanceTailCallback-Funktion wird aufgerufen, wenn die CLFS-Verwaltung anfordert, dass der Client sein Protokollfragment erweitert.

Die ClfsAdvanceTailCallback-Funktion muss vor der Rückgabe nur einen minimalen Verarbeitungsaufwand ausführen. Die ClfsAdvanceTailCallback-Funktion kann beispielsweise das folgende Verfahren ausführen:

Wenn die Anforderung nicht verarbeitet werden kann, geben Sie einen Fehler status zurück.
Wenn die Anforderung verarbeitet werden kann, erstellen Sie ein Arbeitselement, und stellen Sie es in die Warteschlange, um die Aktionen auszuführen, die erforderlich sind, um das Ende des Clients zu verschieben, und geben Sie dann STATUS_PENDING zurück. Weitere Informationen zum Anstehen eines Workerthreads finden Sie unter System Workerthreads.

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 als auch die benutzerdefinierten Daten bereit, die als Parameter an die ClfsAdvanceTailCallback-Funktion übergeben werden, wenn diese Funktion aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform	Desktop
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Aufgerufen am IRQL <= APC_LEVEL

Weitere Informationen

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure

Freigeben über