Fonction FltDetachVolume (fltkernel.h)

Article
02/26/2024

FltDetachVolume détache un pilote de minifiltre instance 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 avoir la valeur NULL.

[in, out] Volume

Pointeur de volume opaque pour le volume sur lequel le instance est attaché. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

[in, optional] InstanceName

Pointeur vers une structure de UNICODE_STRING contenant le nom instance du instance à supprimer. Ce paramètre est facultatif et peut être NULL. S’il est NULL, le instance correspondant le plus élevé est supprimé.

Valeur retournée

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

Code de retour	Description
STATUS_FLT_DELETING_OBJECT	FltDetachVolume a trouvé un instance correspondant, mais le instance est en cours de démontage. 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 un pilote de minifiltre instance d’un volume et déchire le instance.

Pour attacher un pilote minifiltre instance à un volume, appelez FltAttachVolume ou FltAttachVolumeAtAltitude.

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

Configuration requise

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

Voir aussi

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName

Partager via