Condividi tramite


Funzione FltDetachVolume (fltkernel.h)

FltDetachVolume scollega un'istanza del driver minifilter da un volume.

Sintassi

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

Parametri

[in, out] Filter

Puntatore di filtro opaco per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in, out] Volume

Puntatore al volume opaco per il volume in cui è collegata l'istanza. Questo parametro è obbligatorio e non può essere NULL.

[in, optional] InstanceName

Puntatore a una struttura UNICODE_STRING contenente il nome dell'istanza da rimuovere. Questo parametro è facoltativo e può essere NULL. Se è NULL, l'istanza corrispondente più alta viene rimossa.

Valore restituito

FltDetachVolume restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito Descrizione
STATUS_FLT_DELETING_OBJECT
FltDetachVolume ha trovato un'istanza corrispondente, ma l'istanza viene rimossa. Si tratta di un codice di errore.
STATUS_FLT_INSTANCE_NOT_FOUND
Non è stata trovata alcuna istanza corrispondente. Si tratta di un codice di errore.

Commenti

FltDetachVolume scollega un'istanza del driver minifilter da un volume e rimuove l'istanza.

Per collegare un'istanza del driver minifilter a un volume, chiamare FltAttachVolume o FltAttachVolumeAtAltitude.

Per confrontare le altitudini di due istanze del driver minifilter associate allo stesso volume, chiamare FltCompareInstanceAltitudes.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione fltkernel.h (includere Fltkernel.h)
Libreria FltMgr.lib
IRQL <= APC_LEVEL

Vedi anche

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName