Función FltGetEcpListFromCallbackData (fltkernel.h)

Artículo
08/07/2023

La rutina FltGetEcpListFromCallbackData devuelve un puntero a una lista adicional de estructura de contexto de parámetros de creación (ECP) asociada a un objeto callback-data de operación de creación determinado.

Sintaxis

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] 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.

[out] EcpList

Recibe un puntero a la lista ECP asociada al objeto callbackData callback-data .

Valor devuelto

FltGetEcpListFromCallbackData devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	EcpList recibió un puntero a la lista ecp asociada al objeto de datos de devolución de llamada especificado. Si el objeto callback-data no tiene ECP asociado, se devuelve STATUS_SUCCESS y EcpList es NULL.
STATUS_INVALID_PARAMETER	El objeto de datos de devolución de llamada especificado no era una operación de creación basada en IRP. En este caso, EcpList no está definido.

Comentarios

Para adjuntar una lista ECP a un objeto callback-data, use la rutina FltSetEcpListIntoCallbackData .

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