Función FltFindExtraCreateParameter (fltkernel.h)

Artículo
02/29/2024

La rutina FltFindExtraCreateParameter busca en una lista de ECP determinada una estructura de contexto ECP de un tipo determinado y devuelve un puntero a esta estructura si se encuentra.

Sintaxis

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] 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 y cuando se cargue el controlador de minifiltro.

[in] EcpList

Puntero a la estructura de lista ECP en la que se va a buscar la estructura de contexto ECP (dada por el parámetro EcpType ).

[in] EcpType

Puntero a un GUID que identifica de forma única cada estructura de contexto ecp. La rutina FltFindExtraCreateParamter usa este valor GUID para determinar si la estructura del contexto ECP existe en la lista ECP (dada por el parámetro EcpList ).

[out, optional] EcpContext

Parámetro opcional que recibe un puntero a la estructura de contexto ecp encontrada. Si no se encuentra la estructura de contexto ecp en la lista ecp, EcpContext se establece en NULL. Si El autor de la llamada establece EcpContext en NULL , se puede usar el valor devuelto de esta rutina para determinar si la estructura del contexto ecp está en la lista ecp.

[out, optional] EcpContextSize

Parámetro opcional que recibe el tamaño, en bytes, de la estructura de contexto ECP encontrada. Si no se encuentra la estructura de contexto ecp en la lista ecp, EcpContextSize se establece en cero.

Valor devuelto

FltFindExtraCreateParameter devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La estructura de contexto ECP (especificada por el parámetro EcpType ) se encontró en la lista ECP (según lo especificado por el parámetro EcpList ).
STATUS_NOT_FOUND	No se encontró la estructura de contexto ECP (especificada por el parámetro EcpType ) en la lista ECP (según lo especificado por el parámetro EcpList ).

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