PCLFS_CLIENT_LOG_UNPINNED_CALLBACK Rückruffunktion (wdm.h)

  • Artikel

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

Weitere Informationen

CLFS_MGMT_CLIENT_REGISTRATION

ClfsMgmtHandleLogFileFull