Fonction FltDeleteStreamContext (fltkernel.h)

Article
02/26/2024

FltDeleteStreamContext supprime un contexte qu’un pilote minifilter donné instance a défini pour un flux donné et marque le contexte de suppression.

Syntaxe

NTSTATUS FLTAPI FltDeleteStreamContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *OldContext
);

Paramètres

[in] Instance

Opaque instance pointeur pour le pilote minifilter instance dont le contexte doit être supprimé de la liste des contextes attachés au flux de fichiers.

[in] FileObject

Pointeur vers un objet fichier pour le flux de fichier.

[out] OldContext

Pointeur vers une variable allouée par l’appelant qui reçoit l’adresse du contexte supprimé. Ce paramètre est facultatif et peut être NULL. Si OldContext n’a pas la valeur NULL et ne pointe pas vers NULL_CONTEXT, l’appelant est chargé d’appeler FltReleaseContext pour libérer ce contexte lorsqu’il n’est plus nécessaire.

Valeur retournée

FltDeleteStreamContext retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que l’une des valeurs suivantes :

Code de retour	Description
STATUS_FLT_DELETING_OBJECT	L’instance spécifiée est en cours de déclassée. Il s’agit d’un code d’erreur.
STATUS_NOT_FOUND	Aucun contexte correspondant n’a été trouvé. Il s’agit d’un code d’erreur.
STATUS_NOT_SUPPORTED	Le système de fichiers ne prend pas en charge les contextes par flux pour ce flux de fichiers. Il s’agit d’un code d’erreur.

Remarques

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

Étant donné que les contextes sont comptés en référence, il n’est généralement pas nécessaire qu’un pilote minifilter appelle une routine telle que FltDeleteStreamContext pour supprimer explicitement un contexte.

Un pilote minifilter appelle FltDeleteStreamContext pour supprimer un contexte d’un flux de fichier et marquer le contexte de suppression. Le contexte est généralement libéré immédiatement, sauf s’il y a une référence en attente sur celui-ci (par exemple, parce que le contexte est toujours utilisé par un autre thread).

Pour allouer un nouveau contexte, appelez FltAllocateContext.

Pour obtenir un contexte de flux, appelez FltGetStreamContext.

Pour définir un contexte de flux, appelez FltSetStreamContext.