Función FltSetEcpListIntoCallbackData (fltkernel.h)

Artículo
02/06/2025

La rutina FltSetEcpListIntoCallbackData adjunta una lista adicional de estructura de contexto de parámetros de creación (ECP) a un objeto de devolución de llamada de operación de creación.

Sintaxis

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

Parámetros

[in] Filter

Puntero de filtro opaco al controlador de minifiltro. Este puntero identifica de forma única el controlador de minifiltro y permanece constante siempre que se cargue el controlador de minifiltro.

CallbackData

Puntero a un objeto callback-data de tipo FLT_CALLBACK_DATA, que representa la operación de creación.

[in] EcpList

Puntero a la lista ECP, que contiene uno o varios ECP, que se van a adjuntar al objeto de datos de devolución de llamada.

Valor devuelto

FltSetEcpListIntoCallbackData devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La lista ECP especificada se adjuntó correctamente al objeto de datos de devolución de llamada especificado.
STATUS_INVALID_PARAMETER_2	El objeto de datos de devolución de llamada especificado no era una operación de creación basada en IRP.
STATUS_INVALID_PARAMETER_3	Ya se ha adjuntado una lista ECP al objeto de datos de devolución de llamada especificado.

Observaciones

La rutina FltSetEcpListIntoCallbackData proporciona un mecanismo para pasar parámetros de creación adicionales a la pila de filtros del sistema de archivos a minifiltro subyacente y controladores de filtro heredados.

Para recuperar una lista ecP adjunta de un objeto de datos de devolución de llamada determinado, use la rutina FltGetEcpListFromCallbackData.

Requisitos

Requisito	Valor
cliente mínimo admitido	Esta rutina está disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya Fltkernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	<= APC_LEVEL