PCLFS_CLIENT_LOG_UNPINNED_CALLBACK Rückruffunktion (wdm.h)
Die ClfsLogUnpinnedCallback-Funktion implementiert alle Aktionen, die der Client ausführen wird, wenn ein zuvor angeheftetes Protokoll gelöst wird.
Syntax
PCLFS_CLIENT_LOG_UNPINNED_CALLBACK PclfsClientLogUnpinnedCallback;
void PclfsClientLogUnpinnedCallback(
[in] PLOG_FILE_OBJECT LogFile,
[in] PVOID ClientData
)
{...}
Parameter
[in] LogFile
Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die den CLFS-Protokolldatenstrom darstellt, dessen Tail gelöst wurde.
[in] ClientData
Ein Zeiger auf vom Client bereitgestellte Informationen. Sie geben diese Daten im LogUnpinnedCallbackData Element der CLFS_MGMT_CLIENT_REGISTRATION Struktur an.
Rückgabewert
Nichts
Bemerkungen
Wenn ein Client die ClfsMgmtHandleLogFileFull Routine- und CLFS-Verwaltung anschließend die ClfsLogGrowthCompleteCallback-Funktion des Clients mit dem Wert TRUE- für den LogIsPinned Parameter aufgerufen hat, dann wird die ClfsLogUnpinnedCallback Funktion aufgerufen, wenn das Protokoll gelöst wird.
Wenn ein Client die ClfsMgmtRegisterManagedClient Routine zum Registrieren bei der CLFS-Verwaltung verwendet, stellt der Client sowohl einen Zeiger auf die ClfsLogUnpinnedCallback--Funktion und die benutzerdefinierten Daten bereit, die als Parameter an die ClfsLogUnpinnedCallback- funktion übergeben werden, wenn diese Funktion aufgerufen wird.
Die ClfsLogUnpinnedCallback--Funktion sollte vor der Rückgabe nur eine minimale Verarbeitungsmenge ausführen. Beispielsweise kann eine Arbeitsaufgabe erstellt und in die Warteschlange gestellt werden, um den Client darüber zu informieren, dass er die Verarbeitung fortsetzen kann.
Die ClfsLogGrowthCompleteCallback--Funktion wird vor der ClfsLogUnpinnedCallback-funktion aufgerufen.
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 |