Função FltSetEcpListIntoCallbackData (fltkernel.h)

Artigo
02/06/2025

A rotina FltSetEcpListIntoCallbackData anexa uma lista ECP (estrutura de contexto de parâmetro de criação extra) a um objeto de criação de dados de retorno de chamada de operação.

Sintaxe

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

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.

CallbackData

Ponteiro para um objeto de retorno de chamada de dados do tipo FLT_CALLBACK_DATA, que representa a operação de criação.

[in] EcpList

Ponteiro para a lista ECP, que contém um ou mais ECPs, a ser anexado ao objeto de retorno de chamada de dados.

Valor de retorno

FltSetEcpListIntoCallbackData retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	A lista ECP fornecida foi anexada com êxito ao objeto de dados de retorno de chamada fornecido.
STATUS_INVALID_PARAMETER_2	O objeto de dados de retorno de chamada fornecido não era uma operação de criação baseada em IRP.
STATUS_INVALID_PARAMETER_3	Uma lista ECP já foi anexada ao objeto de retorno de chamada fornecido.

Observações

A rotina FltSetEcpListIntoCallbackData fornece um mecanismo para passar parâmetros de criação extra para baixo da pilha de filtro do sistema de arquivos para drivers de filtros herdados e minifiltro subjacentes.

Para recuperar uma lista ECP anexada de um determinado objeto de retorno de chamada de dados, use a rotina FltGetEcpListFromCallbackData.

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

FLT_CALLBACK_DATA

FltAcknowledgeEcp

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltDeleteExtraCreateParameterLookasideList

FltFindExtraCreateParameter

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetEcpListFromCallbackData

FltGetNextExtraCreateParameter

FltInitExtraCreateParameterLookasideList

FltInsertExtraCreateParameter

FltIsEcpAcknowledged

FltIsEcpFromUserMode

FltRemoveExtraCreateParameter

IoCreateFileEx

Partilhar via