Función FltInsertExtraCreateParameter (fltkernel.h)

Artículo
02/26/2024

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 y cuando 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 de 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 especificada 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.

Comentarios

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

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

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