Función FltSetEcpListIntoCallbackData (fltkernel.h)

Artículo
02/26/2024

La rutina FltSetEcpListIntoCallbackData adjunta una lista de estructura de contexto de parámetros de creación adicional (ECP) a un objeto callback-data de la 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 de datos de devolución de llamada 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 de 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.

Comentarios

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	Value
Cliente mínimo compatible	Esta rutina está disponible a partir de Windows Vista.
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	FltMgr.lib
Archivo DLL	Fltmgr.sys
IRQL	<= APC_LEVEL