Compartir a través de


Función FltGetNextExtraCreateParameter (fltkernel.h)

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

Consulte también

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx

Uso de GUID en controladores