Função FltDetachVolume (fltkernel.h)

  • Artigo

FltDetachVolume desanexa uma instância de driver de minifiltro de um volume.

Sintaxe

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

Parâmetros

[in, out] Filter

Ponteiro de filtro opaco para o chamador. Esse parâmetro é necessário e não pode ser NULL.

[in, out] Volume

Ponteiro de volume opaco para o volume em que a instância está anexada. Esse parâmetro é necessário e não pode ser NULL.

[in, optional] InstanceName

Ponteiro para uma estrutura UNICODE_STRING que contém o nome da instância para a instância a ser removida. Esse parâmetro é opcional e pode ser NULL. Se for NULL, a instância correspondente mais alta será removida.

Retornar valor

FltDetachVolume retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno Descrição
STATUS_FLT_DELETING_OBJECT
 FltDetachVolume encontrou uma instância correspondente, mas a instância está sendo interrompida. Este é um código de erro.
STATUS_FLT_INSTANCE_NOT_FOUND
 Nenhuma instância correspondente foi encontrada. Este é um código de erro.

Comentários

FltDetachVolume desanexa uma instância de driver de minifiltro de um volume e remove a instância.

Para anexar uma instância de driver de minifiltro a um volume, chame FltAttachVolume ou FltAttachVolumeAtAltitude.

Para comparar as altitudes de duas instâncias de driver de minifiltro anexadas ao mesmo volume, chame FltCompareInstanceAltitudes.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
IRQL <= APC_LEVEL

Confira também

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName