Función FltGetNextExtraCreateParameter (fltkernel.h)

Artículo
02/06/2025

La rutina FltGetNextExtraCreateParameter devuelve un puntero a la siguiente estructura de contexto de creación de parámetros (o primero) adicional en una lista de ECP determinada.

Sintaxis

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

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 que se cargue el controlador de minifiltro.

[in] EcpList

Puntero a la lista ECP que se va a examinar.

[in, optional] CurrentEcpContext

Puntero opcional a un ECP en la lista de ECP especificada. Si está presente, fltGetNextExtraCreateParameter devuelve el ECP después de la CurrentEcpContext ECP. Si CurrentEcpContext es NULL, FltGetNextExtraCreateParameter devuelve el primer ECP de la lista.

[out, optional] NextEcpType

Parámetro opcional que recibe un puntero al GUID del ECP devuelto.

[out, optional] NextEcpContext

Parámetro opcional que recibe un puntero al ECP devuelto.

[out, optional] NextEcpContextSize

Parámetro opcional que recibe el tamaño, en bytes, del ECP devuelto.

Valor devuelto

FltGetNextExtraCreateParameter devuelve uno de los siguientes valores NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	Se encontró un ECP en la lista ecpList ecpList ECP.
STATUS_NOT_FOUND	La ecpList lista ECP está vacía o currentEcpContext es el último ECP de la lista, es decir, no hay ningún elemento de lista ECP siguiente). Además, NextEcpContext se establece en NULL y NextEcpContextSize está establecido en cero.
STATUS_INVALID_PARAMETER	El parámetro ecpList de es NULL.

Observaciones

Esta rutina está disponible a partir de Windows Vista.

La rutinaFltGetNextExtraCreateParameter procesa una lista ecP de manera no circular. Es decir, si el ECP al que apunta el parámetro CurrentEcpContext es el último elemento ECP de la lista ECP, no hay ningún ECP "siguiente" en la lista y la rutina devuelve STATUS_NOT_FOUND.

Requisitos

Requisito	Valor
cliente mínimo admitido	Esta rutina está disponible a partir de Windows Vista.
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