PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK Rückruffunktion (wdm.h)

Artikel
02/07/2025

Die ClfsLogGrowthCompleteCallback-Funktion implementiert die Aktionen, die der Client ausführen wird, wenn Speicherplatz in einem Protokoll freigegeben wird, das zuvor voll war.

Syntax

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

Ein Zeiger auf eine LOG_FILE_OBJECT-Struktur, die den CLFS-Protokolldatenstrom darstellt, dessen Protokoll den Zuwachs beendet hat.

[in] OperationStatus

Der Status der früheren Anforderung des Clients zum Behandeln einer vollständigen Bedingung einer Protokolldatei. Dies ist entweder STATUS_SUCCESS oder ein Fehlerstatus, der angibt, warum die Anforderung nicht erfolgreich abgeschlossen werden konnte.

[in] LogIsPinned

Gibt TRUEan, dass der Protokollschwanz aktuell angeheftet ist; FALSE, wenn der Protokollschwanz nicht angeheftet ist.

[in] ClientData

Ein Zeiger auf vom Client bereitgestellte Informationen.

Rückgabewert

Nichts

Bemerkungen

Da ein Aufruf von ClfsMgmtHandleLogFileFul l asynchron abgeschlossen wird, gehören alle Aktionen, die der Client ausführen wird, wenn die vollständige Bedingung der Protokolldatei in der ClfsLogGrowthCompleteCallback Funktion behandelt wurde.

Wenn ein Aufruf der ClfsMgmtHandleLogFileFull zurückgegebene Routine STATUS_PENDING zurückgibt, wird die ClfsLogGrowthCompleteCallback--Funktion aufgerufen, wenn der Vorgang abgeschlossen ist. Wenn ein anderer Status zurückgegeben wurde, wird die ClfsLogGrowthCompleteCallback--Funktion nicht aufgerufen.

Die ClfsLogGrowthCompleteCallback--Funktion sollte vor der Rückgabe nur eine minimale Verarbeitungsmenge ausführen. Die ClfsLogGrowthCompleteCallback--Funktion kann z. B. das folgende Verfahren befolgen:

Wenn der Wert des OperationStatus--Parameters ein Fehlerstatus ist, geben Sie den Wert zurück.
Wenn der Wert des OperationStatus Parameter STATUS_SUCCESS ist, erstellen und in die Warteschlange eine Arbeitsaufgabe, um den Client darüber zu informieren, dass er die Verarbeitung fortsetzen kann.

Wenn ein Client die ClfsMgmtRegisterManagedClient Routine zum Registrieren bei der CLFS-Verwaltung verwendet, stellt der Client sowohl einen Zeiger auf die ClfsLogGrowthCompleteCallback--Funktion und die benutzerdefinierten Daten bereit, die als Parameter an die ClfsLogGrowthCompleteCallback 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

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient

Freigeben über