функция обратного вызова PFLT_CONTEXT_CLEANUP_CALLBACK (fltkernel.h)
Драйвер минифильтра может зарегистрировать подпрограмму типа PFLT_CONTEXT_CLEANUP_CALLBACK в качестве подпрограммы ContextCleanupCallback драйвера мини-фильтра.
Синтаксис
PFLT_CONTEXT_CLEANUP_CALLBACK PfltContextCleanupCallback;
void PfltContextCleanupCallback(
[in] PFLT_CONTEXT Context,
[in] FLT_CONTEXT_TYPE ContextType
)
{...}
Параметры
[in] Context
Указатель на часть контекста драйвера минифильтра.
[in] ContextType
Тип контекста. Необходимо установить одно из следующих значений.
FLT_FILE_CONTEXT (начиная с Windows Vista)
FLT_INSTANCE_CONTEXT
FLT_STREAM_CONTEXT
FLT_STREAMHANDLE_CONTEXT
FLT_SECTION_CONTEXT (начиная с Windows 8)
FLT_TRANSACTION_CONTEXT (начиная с Windows Vista)
FLT_VOLUME_CONTEXT
Возвращаемое значение
None
Remarks
Драйвер минифильтра может при необходимости указать подпрограмму типа PFLT_CONTEXT_CLEANUP_CALLBACK в качестве подпрограммы ContextCleanupCallback драйвера минифильтра для каждого типа контекста, который он регистрирует при вызове FltRegisterFilter из своей подпрограммы DriverEntry . Чтобы указать эту подпрограмму, драйвер минифильтра сохраняет указатель на подпрограмму в элементе ContextCleanupCallback структуры FLT_CONTEXT_REGISTRATION для типа контекста.
Если драйвер мини-фильтра указывает подпрограмму ContextCleanupCallback для типа контекста, диспетчер фильтров вызывает эту подпрограмму, прежде чем освобождать контексты драйвера минифильтра этого типа. В этой процедуре драйвер минифильтра выполняет любую необходимую очистку, например освобождает дополнительную память, выделенную драйвером минифильтра внутри структуры контекста. После возврата подпрограммы ContextCleanupCallback диспетчер фильтров освобождает контекст.
Дополнительные сведения о регистрации контекста см. в справочной записи для FLT_CONTEXT_REGISTRATION.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | fltkernel.h (включая Fltkernel.h) |
| IRQL | <=APC_LEVEL |