Função FltFindExtraCreateParameter (fltkernel.h)

Artigo
02/06/2025

A rotina FltFindExtraCreateParameter pesquisa uma determinada lista ECP para uma estrutura de contexto ECP de um determinado tipo e retorna um ponteiro para essa estrutura se ela for encontrada.

Sintaxe

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

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 estrutura de lista ECP na qual pesquisar a estrutura de contexto ECP (fornecida pelo parâmetro EcpType).

[in] EcpType

Ponteiro para um GUID que identifica exclusivamente cada estrutura de contexto ECP. Esse valor GUID é usado pela rotina FltFindExtraCreateParamter para determinar se a estrutura de contexto ECP existe na lista ECP (fornecida pelo parâmetro EcpList).

[out, optional] EcpContext

Parâmetro opcional que recebe um ponteiro para a estrutura de contexto ECP encontrada. Se a estrutura de contexto ECP não for encontrada na lista ECP, EcpContext será definido como NULL. Se EcpContext for definido como NULL pelo chamador, o valor retornado dessa rotina poderá ser usado para determinar se a estrutura de contexto ECP está na lista ECP.

[out, optional] EcpContextSize

Parâmetro opcional que recebe o tamanho, em bytes, da estrutura de contexto ECP encontrada. Se a estrutura de contexto ECP não for encontrada na lista ECP, EcpContextSize será definida como zero.

Valor de retorno

FltFindExtraCreateParameter retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	A estrutura de contexto ECP (conforme especificado pelo parâmetro EcpType) foi encontrada na lista ECP (conforme especificado pelo parâmetro EcpList).
STATUS_NOT_FOUND	A estrutura de contexto ECP (conforme especificado pelo parâmetro EcpType) não foi encontrada na lista ECP (conforme especificado pelo parâmetro EcpList).

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

FltAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx

Partilhar via