Freigeben über


FltDetachVolume-Funktion (fltkernel.h)

FltDetachVolume trennt eine Minifiltertreiberinstanz 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 kann nicht NULL-werden.

[in, out] Volume

Undurchsichtiger Volumezeiger für das Volume, an dem die Instanz angefügt ist. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in, optional] InstanceName

Zeigen Sie auf eine UNICODE_STRING Struktur, die den Instanznamen für die zu entfernende Instanz enthält. Dieser Parameter ist optional und kann NULL-werden. Wenn es NULL-ist, wird die höchste übereinstimmende Instanz entfernt.

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_FLT_DELETING_OBJECT
FltDetachVolume eine übereinstimmende Instanz gefunden, aber die Instanz wird heruntergerissen. Dies ist ein Fehlercode.
STATUS_FLT_INSTANCE_NOT_FOUND
Es wurde keine übereinstimmende Instanz gefunden. Dies ist ein Fehlercode.

Bemerkungen

FltDetachVolume eine Minifiltertreiberinstanz von einem Volume trennt und die Instanz herunterreißt.

Um eine Minifiltertreiberinstanz an ein Volume anzufügen, rufen Sie FltAttachVolume oder FltAttachVolumeAtAltitudeauf.

Rufen Sie FltCompareInstanceAltitudesauf, um die Höhe von zwei Minifiltertreiberinstanzen zu vergleichen, die mit demselben Volume verbunden sind.

Anforderungen

Anforderung Wert
Zielplattform- Universal
Header- fltkernel.h (include Fltkernel.h)
Library FltMgr.lib
IRQL- <= APC_LEVEL

Siehe auch

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName