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

Статья
12/21/2024

Драйвер фильтра может зарегистрировать подпрограмму 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, которая указывает на дополнительный тип параметра создания. Дополнительные сведения см. в разделе Using GUIDs in Drivers.

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

Никакой

Замечания

Если драйвер фильтра выделяет структуру контекста 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 (include Ntifs.h, FltKernel.h)
IRQL	PASSIVE_LEVEL