Fonction FltGetTransactionContext (fltkernel.h)

Article
02/27/2024

La routine FltGetTransactionContext récupère un contexte qui a été défini pour une transaction par un pilote de minifiltre donné.

Syntaxe

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

Paramètres

[in] Instance

Pointeur de 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 retournée

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

Code de retour	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 de minifiltre.

FltGetTransactionContext incrémente le nombre de références en fonction du contexte vers lequel pointe le paramètre Context . 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. Par conséquent, 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.