Função FltPrepareToReuseEcp (fltkernel.h)

Artigo
03/01/2024

A rotina FltPrepareToReuseEcp redefine uma estrutura de contexto de parâmetro de criação extra (ECP), que a prepara para reutilização.

Sintaxe

VOID FLTAPI FltPrepareToReuseEcp(
  [in] PFLT_FILTER Filter,
  [in] PVOID       EcpContext
);

Parâmetros

[in] Filter

Um 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] EcpContext

Um ponteiro para o ECP a ser preparado para reutilização.

Valor retornado

Nenhum.

Comentários

O FltPrepareToReuseEcp permite a reutilização de um ECP usado em uma solicitação de criação anterior. Isso impede a necessidade de inicializar um novo ECP com as mesmas informações.

O destino de um ECP usa FltAcknowledgeEcp para marcar o ECP como confirmado. Isso indica que o ECP foi descoberto e processado. Para reutilizar um ECP reconhecido anteriormente, como no processamento de uma nova análise, um driver pode usar FltPrepareToReuseEcp para limpar o estado confirmado do ECP antes de enviá-lo em outra solicitação de criação.

Requisitos

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