Função FltFindExtraCreateParameter (fltkernel.h)

Artigo
08/07/2023

A rotina FltFindExtraCreateParameter pesquisa uma determinada lista de ECP em busca de 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 do 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á definido como zero.

Retornar valor

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
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