PFLT_CONTEXT_FREE_CALLBACK Rückruffunktion (fltkernel.h)

Artikel
02/26/2024

Ein Minifilter kann eine Routine vom Typ PFLT_CONTEXT_FREE_CALLBACK als ContextFreeCallback-Routine des Minifiltertreibers registrieren.

Syntax

PFLT_CONTEXT_FREE_CALLBACK PfltContextFreeCallback;

void PfltContextFreeCallback(
  [in] PVOID Pool,
  [in] FLT_CONTEXT_TYPE ContextType
)
{...}

Parameter

[in] Pool

Ein Zeiger auf den zu freigebenden Kontext.

[in] ContextType

Der Typ des Kontexts. Dieser Parameter ist erforderlich und 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

In den seltenen Fällen, in denen ein Minifiltertreiber seine eigenen Kontexte manuell freigeben muss, kann der Minifiltertreiber eine Routine vom Typ PFLT_CONTEXT_FREE_CALLBACK als ContextFreeCallback-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 ContextFreeCallback-Member der FLT_CONTEXT_REGISTRATION-Struktur für den Kontexttyp.

Weitere Informationen zur Kontextregistrierung finden Sie im Referenzeintrag für FLT_CONTEXT_REGISTRATION.