Compartir a través de

Función FltDetachVolume (fltkernel.h)

  • Artículo

FltDetachVolume separa una instancia de controlador de minifiltro de un volumen.

Sintaxis

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

Parámetros

[in, out] Filter

Puntero de filtro opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.

[in, out] Volume

Puntero de volumen opaco para el volumen donde se adjunta la instancia. Este parámetro es obligatorio y no puede ser NULL.

[in, optional] InstanceName

Puntero a una estructura de UNICODE_STRING que contiene el nombre de instancia de la instancia que se va a quitar. Este parámetro es opcional y puede ser NULL. Si es NULL, se quita la instancia coincidente más alta.

Valor devuelto

FltDetachVolume devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto Descripción
STATUS_FLT_DELETING_OBJECT
 FltDetachVolume encontró una instancia coincidente, pero la instancia se está derribando. Se trata de un código de error.
STATUS_FLT_INSTANCE_NOT_FOUND
 No se encontró ninguna instancia coincidente. Se trata de un código de error.

Comentarios

FltDetachVolume desasocia una instancia del controlador de minifiltro de un volumen y desglosa la instancia.

Para adjuntar una instancia de controlador de minifiltro a un volumen, llame a FltAttachVolume o FltAttachVolumeAtAltitude.

Para comparar las altitudes de dos instancias de controlador de minifiltro asociadas al mismo volumen, llame a FltCompareInstanceAltitudes.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado fltkernel.h (incluya Fltkernel.h)
Library FltMgr.lib
IRQL <= APC_LEVEL

Consulte también

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName