Función FltGetNextExtraCreateParameter (fltkernel.h)

Artículo
02/26/2024

La rutina FltGetNextExtraCreateParameter devuelve un puntero al siguiente (o primero) estructura de contexto de parámetros de creación adicional (ECP) 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 y cuando 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 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 ECP.
STATUS_NOT_FOUND	La lista ecplist ECP está vacía o CurrentEcpContext es la última ECP de la lista que es, no hay ningún elemento de lista ECP siguiente). Además, NextEcpContext se establece en NULL y NextEcpContextSize se establece en cero.
STATUS_INVALID_PARAMETER	El parámetro EcpList es NULL.

Comentarios

Esta rutina está disponible a partir de Windows Vista.

La rutinaFltGetNextExtraCreateParameter procesa una lista ECP de forma 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	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