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

Artículo
12/20/2024

Un controlador de filtro puede registrar una rutina de tipo PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK como la CleanupCallback del controlador de filtro rutina de devolución de llamada para una estructura de contexto de parámetro 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, vea Uso de GUID en Controladores.

Valor devuelto

Ninguno

Observaciones

Cuando un controlador de filtro asigna una estructura de contexto ECP, puede especificar opcionalmente una rutina de tipo PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK como rutina de devolución de llamada del controlador de filtro CleanupCallback. 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 CleanupCallback parámetro 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: