Compartilhar via


Função FltGetEcpListFromCallbackData (fltkernel.h)

A rotina FltGetEcpListFromCallbackData retorna um ponteiro para uma lista de ECP (estrutura de contexto de parâmetro de criação extra) associada a um determinado objeto de dados de retorno de chamada de operação de criação.

Sintaxe

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] PECP_LIST          *EcpList
);

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.

CallbackData

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

[out] EcpList

Recebe um ponteiro para a lista ECP associada ao callbackData objeto callback-data.

Valor de retorno

fltGetEcpListFromCallbackData retorna um dos seguintes valores NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
EcpList recebeu um ponteiro para a lista ECP associada ao objeto de dados de retorno de chamada fornecido. Se o objeto de dados de retorno de chamada não tiver nenhum ECP associado, STATUS_SUCCESS será retornado e EcpList NULL.
STATUS_INVALID_PARAMETER
O objeto de dados de retorno de chamada fornecido não era uma operação de criação baseada em IRP. Nesse caso, EcpList é indefinido.

Observações

Para anexar uma lista ECP a um objeto de dados de retorno de chamada, use a rotina FltSetEcpListIntoCallbackData.

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

FltGetNextExtraCreateParameter

FltInitExtraCreateParameterLookasideList

FltInsertExtraCreateParameter

FltIsEcpAcknowledged

FltIsEcpFromUserMode

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx