FltGetTransactionContext, fonction (fltkernel.h)

Article
02/06/2025

La routine FltGetTransactionContext récupère un contexte défini pour une transaction par un pilote minifilter donné.

Syntaxe

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

Paramètres

[in] Instance

Pointeur d’instance opaque pour l’appelant.

[in] Transaction

Pointeur de transaction opaque pour la transaction dont le contexte est récupéré.

[out] Context

Pointeur vers une variable allouée par l’appelant qui reçoit l’adresse du contexte de transaction.

Valeur de retour

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

Retourner le code	Description
STATUS_NOT_FOUND	Aucun contexte correspondant n’a été trouvé. Il s’agit d’un code d’erreur.

Remarques

Pour plus d’informations sur les contextes, consultez À propos des contextes minifilter.

FltGetTransactionContext incrémente le nombre de références sur le contexte vers lequel pointe le paramètre contexte. Lorsque ce pointeur de contexte n’est plus nécessaire, l’appelant doit décrémenter son nombre de références en appelant FltReleaseContext. Ainsi, chaque appel réussi à FltGetTransactionContext doit être mis en correspondance par un appel ultérieur à FltReleaseContext.

Pour définir un contexte pour une transaction, appelez FltSetTransactionContext.

Pour allouer un nouveau contexte de transaction, appelez FltAllocateContext.

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