Função FltGetNextExtraCreateParameter (fltkernel.h)

Artigo
08/07/2023

A rotina FltGetNextExtraCreateParameter retorna um ponteiro para a próxima (ou primeira) estrutura de contexto de parâmetro de criação extra (ECP) em uma determinada lista de ECP.

Sintaxe

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

Ponteiro de filtro opaco para o driver de minifiltro. Esse ponteiro identifica exclusivamente o driver de minifiltro e permanece constante desde que o driver de minifiltro seja carregado.

[in] EcpList

Ponteiro para a lista ECP a ser examinada.

[in, optional] CurrentEcpContext

Ponteiro opcional para um ECP na lista ECP fornecida. Se presente, FltGetNextExtraCreateParameter retornará o ECP após o ECP CurrentEcpContext . Se CurrentEcpContext for NULL, FltGetNextExtraCreateParameter retornará o primeiro ECP na lista.

[out, optional] NextEcpType

Parâmetro opcional que recebe um ponteiro para o GUID do ECP retornado.

[out, optional] NextEcpContext

Parâmetro opcional que recebe um ponteiro para o ECP retornado.

[out, optional] NextEcpContextSize

Parâmetro opcional que recebe o tamanho, em bytes, do ECP retornado.

Retornar valor

FltGetNextExtraCreateParameter retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	Um ECP foi encontrado na lista ECP EcpList .
STATUS_NOT_FOUND	A lista ECP EcpList está vazia ou CurrentEcpContext é o último ECP na lista, ou seja, não há nenhum próximo elemento de lista ECP). Além disso, NextEcpContext é definido como NULL e NextEcpContextSize é definido como zero.
STATUS_INVALID_PARAMETER	O parâmetro EcpList é NULL.

Comentários

Essa rotina está disponível a partir do Windows Vista.

A rotinaFltGetNextExtraCreateParameter processa uma lista ECP de maneira não circular. Ou seja, se o ECP apontado pelo parâmetro CurrentEcpContext for o último elemento ECP na lista ECP, não haverá nenhum ECP "próximo" na lista e a rotina retornará STATUS_NOT_FOUND.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa rotina está disponível a partir do Windows Vista.
Plataforma de Destino	Universal
Cabeçalho	fltkernel.h (inclua Fltkernel.h)
Biblioteca	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL