функция обратного вызова PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK (ntifs.h)

Статья
08/07/2023

Драйвер фильтра может зарегистрировать PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK типизированные подпрограммы в качестве подпрограммы обратного вызова CleanupCallback драйвера фильтра для дополнительной структуры контекста параметра создания (ECP).

Синтаксис

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

void PfsrtlExtraCreateParameterCleanupCallback(
  [in, out] PVOID EcpContext,
  [in[]     LPCGUID EcpType
)
{...}

Параметры

[in, out] EcpContext

Указатель контекста ECP, возвращенный подпрограммой, которая выделила структуру контекста ECP.

[in[] EcpType

Указатель на GUID, переданный в подпрограмму, которая выделила структуру контекста ECP, которая указывает дополнительный тип параметра create. Дополнительные сведения см. в разделе Использование идентификаторов GUID в разделе Драйверы.

Возвращаемое значение

None

Remarks

Когда драйвер фильтра выделяет структуру контекста ECP, он может при необходимости указать PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK типизированной подпрограммы в качестве подпрограммы обратного вызова CleanupCallback драйвера фильтра. Если драйвер фильтра указывает подпрограмму обратного вызова CleanupCallback , операционная система вызовет подпрограмму CleanupCallback (независимо от уровня IRQ). Эта подпрограмма CleanupCallback выполняет все необходимые операции очистки, связанные с контекстом ECP, при удалении структуры контекста ECP.

Чтобы указать подпрограмму обратного вызова, драйвер фильтра передает указатель на подпрограмму обратного вызова с помощью параметра CleanupCallback подпрограммы, которая первоначально выделила структуру контекста ECP. Если подпрограмма обратного вызова не требуется, необходимо передать значение NULL в параметр CleanupCallback .

Следующие подпрограммы поддерживают PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK типизированной процедуры обратного вызова:

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Целевая платформа	Персональный компьютер
Верхняя часть	ntifs.h (включая Ntifs.h, FltKernel.h)
IRQL	PASSIVE_LEVEL