Função FltGetNextExtraCreateParameter (fltkernel.h)

Artigo
02/06/2025

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 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 estiver presente, FltGetNextExtraCreateParameter retornará o ECP após o CurrentEcpContext ECP. Se CurrentEcpContext for NULL, FltGetNextExtraCreateParameter retornará o primeiro ECP da 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.

Valor de retorno

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 EcpList ECP está vazia ou CurrentEcpContext é o último ECP na lista que é, não há nenhum próximo elemento de lista ECP). Além disso, NextEcpContext é definido como NULL e NextEcpContextSize está definido como zero.
STATUS_INVALID_PARAMETER	O parâmetro EcpList é NULL.

Observações

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

A rotina FltGetNextExtraCreateParameter 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
de cliente com suporte mínimo	Essa rotina está disponível a partir do Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	fltkernel.h (inclua Fltkernel.h)
biblioteca	FltMgr.lib
de DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

Consulte também

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx

usando GUIDs em drivers

Partilhar via