Função FltPrepareComplete (fltkernel.h)

Artigo
08/07/2023

A rotina FltPrepareComplete reconhece uma notificação de TRANSACTION_NOTIFY_PREPARE.

Sintaxe

NTSTATUS FLTAPI FltPrepareComplete(
  [in]           PFLT_INSTANCE Instance,
  [in]           PKTRANSACTION Transaction,
  [in, optional] PFLT_CONTEXT  TransactionContext
);

Parâmetros

[in] Instance

Ponteiro de instância opaco para o chamador.

[in] Transaction

Ponteiro de transação opaco para a transação.

[in, optional] TransactionContext

Ponteiro para o contexto de transação do driver de minifiltro.

Retornar valor

FltPrepareComplete retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno	Descrição
STATUS_NOT_FOUND	O driver de minifiltro não definiu um contexto na transação. Este é um código de erro.

Comentários

Um driver de minifiltro que é inscrito em uma transação pode receber uma notificação de TRANSACTION_NOTIFY_PREPARE quando a transação entra na fase de preparação para confirmação. Para enviar a notificação para o driver de minifiltro, o gerenciador de filtros chama a rotina TransactionNotificationCallback do driver de minifiltro. O driver de minifiltro reconhece essa notificação de duas maneiras:

A rotina TransactionNotificationCallback do driver de minifiltro executa qualquer processamento necessário e retorna STATUS_SUCCESS. Nesse caso, o driver de minifiltro não chama FltPrepareComplete.
A rotina TransactionNotificationCallback do driver de minifiltro posta qualquer processamento necessário em um thread de trabalho e retorna STATUS_PENDING. Depois de executar o processamento de forma assíncrona, a rotina de trabalho do driver de minifiltro deve chamar FltPrepareComplete para indicar que ele terminou esse processamento. Se a rotina de trabalho do driver de minifiltro não chamar FltPrepareComplete, a operação de preparação da transação não poderá ser concluída pelo gerenciador de transações do kernel.

Para registrar uma rotina TransactionNotificationCallback , um driver de minifiltro armazena o endereço de uma rotina do tipo PFLT_TRANSACTION_NOTIFICATION_CALLBACK no membro TransactionNotificationCallback da estrutura FLT_REGISTRATION que o driver de minifiltro passa como o parâmetro Registration de FltRegisterFilter.

Para se inscrever em uma transação, chame FltEnlistInTransaction.

Para alocar um novo contexto de transação, chame FltAllocateContext.

Para recuperar um contexto de transação, chame FltGetTransactionContext.

Para excluir um contexto de transação, chame FltDeleteTransactionContext ou FltDeleteContext.

Para definir um contexto de transação, chame FltSetTransactionContext.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	A rotina FltPrepareComplete está disponível no Windows Vista e posterior.
Plataforma de Destino	Universal
Cabeçalho	fltkernel.h (inclua Fltkernel.h)
Biblioteca	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL