PFLT_CONTEXT_CLEANUP_CALLBACK Rückruffunktion (fltkernel.h)

Artikel
03/01/2024

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.