Función FltRemoveExtraCreateParameter (fltkernel.h)

Artículo
08/07/2023

La rutina FltRemoveExtraCreateParameter busca una lista de ECP para obtener una estructura de contexto ECP y, si se encuentra, la desasocia de la lista ECP.

Sintaxis

NTSTATUS FLTAPI FltRemoveExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in, out]       PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out]           PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

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, out] EcpList

Puntero a la lista de parámetros de creación adicional (ECP) que contiene la estructura de contexto ecp que se va a desasociar de la lista especificada.

[in] EcpType

Puntero a un GUID definido por el usuario que identifica de forma única la estructura de contexto ECP que se va a desasociar de la lista.

[out] EcpContext

Puntero a la estructura de contexto ECP desasociada. Si la estructura del contexto ECP se desasocia correctamente de la lista especificada, este parámetro se establecerá para que apunte a la estructura de contexto ECP desasociada. Si la estructura del contexto ECP no se encuentra en la lista de ECP especificada, este parámetro se establece en NULL.

[out, optional] EcpContextSize

Parámetro opcional que recibe el tamaño de la estructura de contexto ECP desasociada. Si este parámetro está presente cuando se llama a la rutina, el parámetro recibirá el tamaño, en bytes, de la estructura de contexto ECP desasociada. Si la estructura de contexto ECP especificada no se encontró en la lista de ECP especificada, este parámetro no está definido.

Valor devuelto

FltRemoveExtraCreateParameter devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La estructura de contexto ECP dada se desasogró correctamente de la lista de ECP especificada.
STATUS_NOT_FOUND	La estructura de contexto ECP especificada no se encontró en la lista de ECP especificada.

Comentarios

La rutina FltRemoveExtraCreateParameter busca en la lista ECP dada por el parámetro EcpList una estructura de contexto ECP dada por el parámetro EcpType . Si la estructura de contexto ECP existe en la lista, se desasocia de la lista, el parámetro EcpContext se establece para que apunte a ella y la rutina devuelve STATUS_SUCCESS. Si la estructura de contexto ECP no existe en la lista, el parámetro EcpContext se establece en NULL y la rutina devuelve STATUS_NOT_FOUND.

Nota Esta rutina no libera el grupo de memoria para la estructura de contexto ecp. Para liberar la estructura de contexto ECP, primero llame a esta rutina para desasociarla de la lista y, a continuación, llame a la rutina FltFreeExtraCreateParameter para liberar la propia 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