Compartir a través de


Función FltInsertExtraCreateParameter (fltkernel.h)

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

Consulte también

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx