FltCommitComplete, fonction (fltkernel.h)

Article
02/06/2025

La routine FltCommitComplete reconnaît une notification TRANSACTION_NOTIFY_COMMIT.

Syntaxe

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

Paramètres

[in] Instance

Pointeur d’instance opaque pour l’appelant.

[in] Transaction

Pointeur de transaction opaque pour la transaction.

[in, optional] TransactionContext

Pointeur vers le contexte du pilote minifilter pour la transaction. Ce paramètre est facultatif et peut être NULL.

Valeur de retour

FltCommitComplete retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Retourner le code	Description
STATUS_NOT_FOUND	Le pilote minifilter n’a pas défini de contexte sur la transaction. Il s’agit d’un code d’erreur.

Remarques

Cette routine est disponible sur Windows Vista et versions ultérieures.

Un pilote minifilter inscrit dans une transaction peut recevoir une notification TRANSACTION_NOTIFY_COMMIT lorsque la transaction est en cours de validation. Pour envoyer la notification au pilote minifilter, le gestionnaire de filtre appelle le transactionNotificationCallback du pilote minifilter routine. Le pilote minifilter reconnaît cette notification de l’une des deux manières suivantes :

La routine TransactionNotificationCallback du pilote minifilter effectue tout traitement nécessaire et retourne STATUS_SUCCESS. Dans ce cas, le pilote minifilter n’appelle pas FltCommitComplete.
Le pilote minifilter TransactionNotificationCallback la routine publie tout traitement nécessaire sur un thread de travail et retourne STATUS_PENDING. Après avoir effectué le traitement de manière asynchrone, la routine de travail du pilote minifilter doit appeler FltCommitComplete pour indiquer qu’il a terminé ce traitement. Si la routine de travail du pilote minifilter n’appelle pas FltCommitComplete, l’opération de validation de transaction ne peut pas être effectuée par le gestionnaire de transactions du noyau.

Pour inscrire une routine de TransactionNotificationCallback, un pilote minifilter stocke l’adresse d’une routine de type PFLT_TRANSACTION_NOTIFICATION_CALLBACK dans le membre TransactionNotificationCallback de la structure FLT_REGISTRATION que le pilote minifilter passe en tant que paramètre Registration de FltRegisterFilter.

Pour vous inscrire dans une transaction, appelez FltEnlistInTransaction.

Pour allouer un nouveau contexte de transaction, appelez FltAllocateContext.

Pour récupérer un contexte de transaction, appelez FltGetTransactionContext.

Pour supprimer un contexte de transaction, appelez FltDeleteTransactionContext ou FltDeleteContext.

Pour définir un contexte de transaction, appelez FltSetTransactionContext.