FltDetachVolume-Funktion (fltkernel.h)

  • Artikel

FltDetachVolume trennt einen Minifiltertreiber instance von einem Volume.

Syntax

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

Parameter

[in, out] Filter

Undurchsichtiger Filterzeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in, out] Volume

Undurchsichtiger Volumezeiger für das Volume, auf dem die instance angefügt ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in, optional] InstanceName

Zeiger auf eine UNICODE_STRING-Struktur, die den instance Namen für die zu entfernende instance enthält. Dieser Parameter ist optional und kann NULL sein. Wenn es NULL ist, wird der höchste übereinstimmende instance entfernt.

Rückgabewert

FltDetachVolume gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode Beschreibung
STATUS_FLT_DELETING_OBJECT
 FltDetachVolume hat eine übereinstimmende instance gefunden, aber die instance wird abgerissen. Dies ist ein Fehlercode.
STATUS_FLT_INSTANCE_NOT_FOUND
 Es wurde kein übereinstimmende instance gefunden. Dies ist ein Fehlercode.

Hinweise

FltDetachVolume löst einen Minifiltertreiber instance von einem Volume und reißt den instance ab.

Um einen Minifiltertreiber instance an ein Volume anzufügen, rufen Sie FltAttachVolume oder FltAttachVolumeAtAltitude auf.

Um die Höhen von zwei Minifiltertreiberinstanzen zu vergleichen, die an dasselbe Volume angefügt sind, rufen Sie FltCompareInstanceAltitudes auf.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header fltkernel.h (include Fltkernel.h)
Bibliothek FltMgr.lib
IRQL <= APC_LEVEL

Weitere Informationen

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName