Fonction FltDeleteVolumeContext (fltkernel.h)

Article
08/07/2023

FltDeleteVolumeContext supprime un contexte qu’un pilote de minifiltre donné a défini pour un volume donné et marque le contexte de suppression.

Syntaxe

NTSTATUS FLTAPI FltDeleteVolumeContext(
  [in]            PFLT_FILTER  Filter,
  [in]            PFLT_VOLUME  Volume,
  [out, optional] PFLT_CONTEXT *OldContext
);

Paramètres

[in] Filter

Pointeur de filtre opaque pour l’appelant.

[in] Volume

Pointeur de volume opaque pour le volume.

[out, optional] 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 responsable d’appeler FltReleaseContext pour libérer ce contexte lorsqu’il n’est plus nécessaire.

Valeur retournée

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

Code de retour	Description
STATUS_FLT_DELETING_OBJECT	Le volume spécifié est en cours de démolir. 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.

Remarques

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

Étant donné que les contextes sont comptabilisés en référence, il n’est généralement pas nécessaire pour un pilote de minifiltre d’appeler une routine telle que FltDeleteVolumeContext pour supprimer explicitement un contexte.

Un pilote de minifiltre appelle FltDeleteVolumeContext pour supprimer un contexte d’un volume et marquer le contexte à supprimer. Le contexte est généralement libéré immédiatement, sauf s’il y a une référence en suspens (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 volume, appelez FltGetVolumeContext.

Pour définir un contexte de volume, appelez FltSetVolumeContext.