Função FltGetEcpListFromCallbackData (fltkernel.h)

Artigo
02/26/2024

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 dados de retorno de chamada do tipo FLT_CALLBACK_DATA, que representa a operação de criação.

[out] EcpList

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

Retornar valor

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 callback-data fornecido. Se o objeto callback-data não tiver nenhum ECP associado, STATUS_SUCCESS será retornado e EcpList será NULL.
STATUS_INVALID_PARAMETER	O objeto callback-data fornecido não era uma operação de criação baseada em IRP. Nesse caso, EcpList é indefinido.

Comentários

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

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