Função FltCommitComplete (fltkernel.h)

Artigo
02/06/2025

A rotina de FltCommitComplete reconhece uma notificação de TRANSACTION_NOTIFY_COMMIT.

Sintaxe

NTSTATUS FLTAPI FltCommitComplete(
  [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 do driver de minifiltro para a transação. Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

FltCommitComplete 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.

Observações

Essa rotina está disponível no Windows Vista e posterior.

Um driver de minifiltro que é inscrito em uma transação pode receber uma notificação TRANSACTION_NOTIFY_COMMIT quando a transação estiver em processo de confirmação. Para enviar a notificação para o driver de minifiltro, o gerenciador de filtros chama a rotina de 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 FltCommitComplete.
O TransactionNotificationCallback do driver de minifiltro postagens de rotina qualquer processamento necessário para 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 FltCommitComplete para indicar que concluiu esse processamento. Se a rotina de trabalho do driver de minifiltro não chamar FltCommitComplete, a operação de confirmação de transação não poderá ser concluída pelo gerenciador de transações do kernel.

Para registrar uma rotina de TransactionNotificationCallback, um driver de minifiltro armazena o endereço de uma rotina de PFLT_TRANSACTION_NOTIFICATION_CALLBACK de tipo no TransactionNotificationCallback membro da estrutura FLT_REGISTRATION que o driver de minifiltro passa como o parâmetro de Registro do 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
da Plataforma de Destino	Universal
cabeçalho	fltkernel.h (inclua Fltkernel.h)
biblioteca	Fltmgr.lib
IRQL	PASSIVE_LEVEL

Consulte também

FLT_REGISTRATION

FltAllocateContext

FltDeleteContext

FltDeleteTransactionContext

FltEnlistInTransaction

FltGetTransactionContext

FltPrePrepareComplete

FltPrepareComplete

FltRegisterFilter

FltReleaseContext

FltRollbackComplete

FltRollbackEnlistment

FltSetTransactionContext

PFLT_TRANSACTION_NOTIFICATION_CALLBACK

Compartilhar via