PFLT_CONTEXT_CLEANUP_CALLBACK Rückruffunktion (fltkernel.h)
Ein Minifiltertreiber kann eine Routine vom Typ PFLT_CONTEXT_CLEANUP_CALLBACK als ContextCleanupCallback-Routine des Minifiltertreibers registrieren.
Syntax
PFLT_CONTEXT_CLEANUP_CALLBACK PfltContextCleanupCallback;
void PfltContextCleanupCallback(
[in] PFLT_CONTEXT Context,
[in] FLT_CONTEXT_TYPE ContextType
)
{...}
Parameter
[in] Context
Ein Zeiger auf den Teil des Kontexts des Minifiltertreibers.
[in] ContextType
Der Typ des Kontexts. Dies muss einer der folgenden Werte sein:
FLT_FILE_CONTEXT (ab Windows Vista)
FLT_INSTANCE_CONTEXT
FLT_STREAM_CONTEXT
FLT_STREAMHANDLE_CONTEXT
FLT_SECTION_CONTEXT (ab Windows 8)
FLT_TRANSACTION_CONTEXT (ab Windows Vista)
FLT_VOLUME_CONTEXT
Rückgabewert
Keine
Bemerkungen
Ein Minifiltertreiber kann optional eine Routine vom Typ PFLT_CONTEXT_CLEANUP_CALLBACK als ContextCleanupCallback-Routine des Minifiltertreibers für jeden Kontexttyp angeben, den er registriert, wenn er FltRegisterFilter aus seiner DriverEntry-Routine aufruft. Um diese Routine anzugeben, speichert der Minifiltertreiber einen Zeiger auf die Routine im ContextCleanupCallback-Member der FLT_CONTEXT_REGISTRATION-Struktur für den Kontexttyp.
Wenn der Minifiltertreiber eine ContextCleanupCallback-Routine für einen Kontexttyp angibt, ruft der Filter-Manager diese Routine auf, bevor er einen der Kontexte des Minifiltertreibers dieses Typs freigibt. In dieser Routine führt der Minifiltertreiber alle erforderlichen Bereinigungen durch, z. B. das Freigeben von zusätzlichem Arbeitsspeicher, den der Minifiltertreiber innerhalb der Kontextstruktur zugewiesen hat. Nachdem die ContextCleanupCallback-Routine zurückgegeben wurde, gibt der Filter-Manager den Kontext frei.
Weitere Informationen zur Kontextregistrierung finden Sie im Referenzeintrag für FLT_CONTEXT_REGISTRATION.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | fltkernel.h (include Fltkernel.h) |
| IRQL | <=APC_LEVEL |