FltDetachVolume, fonction (fltkernel.h)

FltDetachVolume détache une instance de pilote minifilter d’un volume.

Syntaxe

NTSTATUS FLTAPI FltDetachVolume(
  [in, out]      PFLT_FILTER      Filter,
  [in, out]      PFLT_VOLUME      Volume,
  [in, optional] PCUNICODE_STRING InstanceName
);

Paramètres

[in, out] Filter

Pointeur de filtre opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas être NULL.

[in, out] Volume

Pointeur de volume opaque pour le volume où l’instance est attachée. Ce paramètre est obligatoire et ne peut pas être NULL.

[in, optional] InstanceName

Pointeur vers une structure UNICODE_STRING contenant le nom de l’instance à supprimer. Ce paramètre est facultatif et peut avoir la valeur NULL. S’il s’agit d’une valeur NULL, l’instance correspondante la plus élevée est supprimée.

Valeur de retour

FltDetachVolume retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, comme l’une des valeurs suivantes :

Code de retour Description
STATUS_FLT_DELETING_OBJECT
FltDetachVolume a trouvé une instance correspondante, mais l’instance est détruite. Il s’agit d’un code d’erreur.
STATUS_FLT_INSTANCE_NOT_FOUND
Aucune instance correspondante n’a été trouvée. Il s’agit d’un code d’erreur.

Remarques

FltDetachVolume détache une instance de pilote minifilter d’un volume et supprime l’instance.

Pour attacher une instance de pilote minifilter à un volume, appelez FltAttachVolume ou FltAttachVolumeAtAltitude.

Pour comparer les altitudes de deux instances de pilote minifilter attachées au même volume, appelez FltCompareInstanceAltitudes.

Configuration requise

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

Voir aussi

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName