Función FltInsertExtraCreateParameter (fltkernel.h)

Artículo
02/06/2025

La rutina FltInsertExtraCreateParameter inserta una estructura de contexto de parámetro de creación adicional (ECP) en una lista ecp.

Sintaxis

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

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.

[in, out] EcpList

Puntero a la estructura de lista ECP a la que se debe agregar la estructura de contexto ECP, proporcionada por el parámetro EcpContext.

[in, out] EcpContext

Puntero a la estructura de contexto ECP que se va a agregar a la lista ECP, proporcionada por el parámetro EcpList.

Valor devuelto

fltInsertExtraCreateParameter devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La estructura de contexto ECP especificada se insertó correctamente en la lista de ECP especificada.
STATUS_INVALID_PARAMETER	La estructura de contexto ECP dada ya existe en la lista de ECP especificada. En el contexto de la inserción de listas ECP, se considera que dos estructuras de contexto ECP son idénticas si contienen valores GUID iguales.

Observaciones

La rutina de FltInsertExtraCreateParameter supone que la estructura de contexto ecP especificada que se va a insertar en la lista ecP especificada se asignó previamente mediante la rutina FltAllocateExtraCreateParameter.

Cada estructura de contexto ECP insertada en la lista ECP debe tener un valor GUID único. Este valor único se establece cuando la rutina de FltAllocateExtraCreateParameter asigna la estructura de contexto ECP.

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