FltGetInstanceContext, fonction (fltkernel.h)

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

Syntaxe

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

Paramètres

[in] Instance

Pointeur d’instance opaque pour l’instance.

[out] Context

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

Valeur de retour

FltGetInstanceContext 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 minifilter.

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

FltGetInstanceContext incrémente le nombre de références sur le contexte auquel pointe le paramètre Context . Lorsque ce pointeur de contexte n’est plus nécessaire, l’appelant doit décréter son nombre de références en appelant FltReleaseContext. Ainsi, chaque appel réussi à FltGetInstanceContext doit être mis en correspondance par un appel suivant à FltReleaseContext.

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

Pour allouer un nouveau contexte, appelez FltAllocateContext.

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

Configuration requise

   
Plateforme cible Universal
En-tête fltkernel.h (include Fltkernel.h)
Bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Voir aussi

FltAllocateContext

FltDeleteContext

FltDeleteInstanceContext

FltReleaseContext

FltSetInstanceContext