Función FltPrepareToReuseEcp (fltkernel.h)

El FltPrepareToReuseEcp rutina restablece una estructura de contexto de parámetro de creación adicional (ECP), que la prepara para su reutilización.

Sintaxis

VOID FLTAPI FltPrepareToReuseEcp(
  [in] PFLT_FILTER Filter,
  [in] PVOID       EcpContext
);

Parámetros

[in] Filter

Puntero de filtro opaco para el 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] EcpContext

Puntero al ECP para prepararse para su reutilización.

Valor devuelto

Ninguno.

Observaciones

El FltPrepareToReuseEcp permite reutilizar un ECP usado en una solicitud de creación anterior. Esto evita tener que inicializar un nuevo ECP con la misma información.

El destino de un ECP usa FltAcknowledgeEcp para marcar el ECP como confirmado. Esto indica que el ECP se detectó y procesó. Para reutilizar un ECP reconocido anteriormente, como en el procesamiento de un análisis, un controlador puede usar FltPrepareToReuseEcp para borrar el estado confirmado del ECP antes de enviarlo en otra solicitud de creación.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows 8.
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

Consulte también

ECP_LIST

FltGetEcpListFromCallbackData

FltIsEcpAcknowledged

FltRemoveExtraCreateParameter

fltSetEcpListIntoCallbackData

FltlInsertExtraCreateParameter