Compartilhar via


Função FltSetEcpListIntoCallbackData (fltkernel.h)

A rotina FltSetEcpListIntoCallbackData anexa uma lista de ECP (estrutura de contexto de parâmetro de criação) extra a um objeto de dados de retorno de chamada de operação de criaçã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 callback-data 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 serem anexados ao objeto callback-data.

Retornar valor

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 callback-data 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 de ECP já foi anexada ao objeto callback-data fornecido.

Comentários

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

Para recuperar uma lista ECP anexada de um determinado objeto callback-data, use a rotina FltGetEcpListFromCallbackData .

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

Confira também

ECP_LIST

FLT_CALLBACK_DATA

FltAcknowledgeEcp

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltDeleteExtraCreateParameterLookasideList

FltFindExtraCreateParameter

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetEcpListFromCallbackData

FltGetNextExtraCreateParameter

FltInitExtraCreateParameterLookasideList

FltInsertExtraCreateParameter

FltIsEcpAcknowledged

FltIsEcpFromUserMode

FltRemoveExtraCreateParameter

IoCreateFileEx