Função FltCommitComplete (fltkernel.h)

Artigo
08/07/2023

A rotina 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.

Retornar valor

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.

Comentários

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

Um driver de minifiltro que está inscrito em uma transação pode receber uma notificação de 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 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.
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 FltCommitComplete para indicar que ele terminou 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 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.