Fonction FltGetInstanceContext (fltkernel.h)

Article
08/07/2023

La routine FltGetInstanceContext récupère un contexte qui a été défini pour un instance par un pilote minifilter donné.

Syntaxe

NTSTATUS FLTAPI FltGetInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *Context
);

Paramètres

[in] Instance

Pointeur de instance opaque pour le instance.

[out] Context

Pointeur vers une variable allouée par l’appelant qui reçoit l’adresse du contexte instance. Ce paramètre est obligatoire et ne peut pas être défini sur NULL.

Valeur retournée

FltGetInstanceContext retourne STATUS_SUCCESS lorsqu’il retourne correctement le contexte de instance demandé. Sinon, elle retourne une valeur NTSTATUS appropriée, telle que la suivante :

Code de retour	Description
STATUS_NOT_FOUND	Aucun contexte correspondant n’a été trouvé sur ce instance pour le moment. FltMgr définit Context sur NULL_CONTEXT. Il s’agit d’un code d’erreur.

Remarques

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

FltGetInstanceContext récupère un contexte qui a été défini pour une instance par un pilote minifilter donné.

FltGetInstanceContext 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. Ainsi, chaque appel réussi à FltGetInstanceContext doit être mis en correspondance par un appel ultérieur à FltReleaseContext.

Pour définir un contexte pour un instance, appelez FltSetInstanceContext.

Pour allouer un nouveau contexte, appelez FltAllocateContext.

Pour supprimer un contexte de fichier, appelez FltDeleteInstanceContext ou FltDeleteContext.