PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK Rückruffunktion (wdm.h)

Artikel
02/27/2024

Die ClfsLogGrowthCompleteCallback-Funktion implementiert die Aktionen, die der Client ausführt, 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 Protokollwachstum abgeschlossen ist.

[in] OperationStatus

Die status der vorherigen Anforderung des Clients, eine vollständige Bedingung für eine Protokolldatei zu behandeln. Dies ist entweder STATUS_SUCCESS oder ein Fehler status, der den Grund dafür angibt, dass die Anforderung nicht erfolgreich abgeschlossen werden konnte.

[in] LogIsPinned

Wenn TRUE, gibt an, dass der Protokollschwanz derzeit angeheftet ist. FALSE , wenn der Protokollschwanz nicht angeheftet ist.

[in] ClientData

Ein Zeiger auf vom Client bereitgestellte Informationen.

Rückgabewert

Keine

Bemerkungen

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

Wenn ein Aufruf der zurückgegebenen ClfsMgmtHandleLogFileFull-Routine STATUS_PENDING zurückgibt, wird die ClfsLogGrowthCompleteCallback-Funktion aufgerufen, wenn der Vorgang abgeschlossen ist. Wenn eine andere status zurückgegeben wurde, wird die ClfsLogGrowthCompleteCallback-Funktion nicht aufgerufen.

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

Wenn der Wert des OperationStatus-Parameters ein Fehler status ist, geben Sie zurück.
Wenn der Wert des OperationStatus-Parameters STATUS_SUCCESS ist, erstellen Sie ein Arbeitselement, und stellen Sie eine Warteschlange bereit, um den Client darüber zu informieren, dass er die Verarbeitung fortsetzen kann.

Wenn ein Client die ClfsMgmtRegisterManagedClient-Routine verwendet, um sich bei der CLFS-Verwaltung zu registrieren, stellt der Client sowohl einen Zeiger auf die ClfsLogGrowthCompleteCallback-Funktion als auch die benutzerdefinierten Daten bereit, die als Parameter an die ClfsLogGrowthCompleteCallback-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 bei IRQL <= APC_LEVEL

Weitere Informationen

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient

Freigeben über