PCLFS_CLIENT_LOG_UNPINNED_CALLBACK Rückruffunktion (wdm.h)
Die ClfsLogUnpinnedCallback-Funktion implementiert alle Aktionen, die der Client ausführt, wenn ein zuvor angeheftetes Protokoll aufgehoben 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 aufgehoben wurde.
[in] ClientData
Ein Zeiger auf vom Client bereitgestellte Informationen. Sie geben diese Daten im LogUnpinnedCallbackData-Member der CLFS_MGMT_CLIENT_REGISTRATION-Struktur an.
Rückgabewert
Keine
Bemerkungen
Wenn ein Client namens ClfsMgmtHandleLogFileFull-Routine und CLFS-Verwaltung anschließend die ClfsLogGrowthCompleteCallback-Funktion des Clients mit dem Wert TRUE für den LogIsPinned-Parameter aufgerufen hat, wird die ClfsLogUnpinnedCallback-Funktion aufgerufen, wenn das Protokoll aufgehoben wird.
Wenn ein Client die ClfsMgmtRegisterManagedClient-Routine verwendet, um sich bei der CLFS-Verwaltung zu registrieren, stellt der Client sowohl einen Zeiger auf die ClfsLogUnpinnedCallback-Funktion als auch 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 einen minimalen Verarbeitungsaufwand ausführen. Beispielsweise kann es ein Arbeitselement erstellen und in die Warteschlange stellen, 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 |
|---|---|
| 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 |