Função FltInsertExtraCreateParameter (fltkernel.h)

Artigo
02/26/2024

A rotina FltInsertExtraCreateParameter insere uma estrutura de contexto ECP (parâmetro de criação extra) em uma lista ECP.

Sintaxe

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

Parâmetros

[in] Filter

Ponteiro de filtro opaco para o driver de minifiltro. Esse ponteiro identifica exclusivamente o driver de minifiltro e permanece constante enquanto o driver de minifiltro é carregado.

[in, out] EcpList

Ponteiro para a estrutura de lista ECP à qual a estrutura de contexto ECP, fornecida pelo parâmetro EcpContext , deve ser adicionada.

[in, out] EcpContext

Ponteiro para a estrutura de contexto ECP a ser adicionada à lista ECP, fornecida pelo parâmetro EcpList .

Retornar valor

FltInsertExtraCreateParameter retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	A estrutura de contexto ECP fornecida foi inserida com êxito na lista ECP fornecida.
STATUS_INVALID_PARAMETER	A estrutura de contexto ECP fornecida já existe na lista ECP fornecida. No contexto de inserção de lista ECP, duas estruturas de contexto ECP são consideradas idênticas se contiverem valores guid iguais.

Comentários

A rotina FltInsertExtraCreateParameter pressupõe que a estrutura de contexto ECP fornecida a ser inserida na lista de ECP fornecida foi alocada anteriormente pela rotina FltAllocateExtraCreateParameter .

Cada estrutura de contexto ECP inserida na lista ECP deve ter um valor GUID exclusivo. Esse valor exclusivo é definido quando a estrutura de contexto ECP é alocada pela rotina FltAllocateExtraCreateParameter .

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