Função FltPrepareToReuseEcp (fltkernel.h)
A rotina FltPrepareToReuseEcp redefine uma estrutura de contexto ECP (parâmetro de criação extra), 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 para se preparar para reutilização.
Valor de retorno
Nenhum.
Observações
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, conforme 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 reconhecido do ECP antes de enviá-lo em outra solicitação de criação.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8. |
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |