PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK función de devolución de llamada (ntifs.h)

Artículo
08/07/2023

Un controlador de filtro puede registrar una rutina con tipo PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK como rutina de devolución de llamada CleanupCallback del controlador de filtro para una estructura de contexto de parámetros de creación adicional (ECP).

Sintaxis

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

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

Parámetros

[in, out] EcpContext

Puntero de contexto ECP devuelto por la rutina que asignó la estructura de contexto ecp.

[in[] EcpType

Puntero a un GUID que se pasó a la rutina que asignó la estructura de contexto ECP, que indica el tipo de parámetro de creación adicional. Para obtener más información, consulte Uso de GUID en controladores.

Valor devuelto

None

Observaciones

Cuando un controlador de filtro asigna una estructura de contexto ECP, opcionalmente puede especificar una rutina con tipo PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK como rutina de devolución de llamada CleanupCallback del controlador de filtro. Si el controlador de filtro especifica una rutina de devolución de llamada CleanupCallback , el sistema operativo invocará la rutina CleanupCallback (independientemente del nivel IRQ). Esta rutina CleanupCallback realiza cualquier procesamiento de limpieza necesario relacionado con el contexto ecP cuando se elimina la estructura de contexto ecp.

Para especificar una rutina de devolución de llamada, un controlador de filtro pasa un puntero a la rutina de devolución de llamada mediante el parámetro CleanupCallback de la rutina que originalmente asignó la estructura de contexto ECP. Si no se necesita una rutina de devolución de llamada, se debe pasar un valor NULL al parámetro CleanupCallback .

Las rutinas siguientes admiten la rutina de devolución de llamada con tipo PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK:

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Plataforma de destino	Escritorio
Encabezado	ntifs.h (incluya Ntifs.h, FltKernel.h)
IRQL	PASSIVE_LEVEL