Função FltDetachVolume (fltkernel.h)
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 de 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 de correspondência mais alta será removida.
Valor de retorno
FltDetachVolume retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:
| Código de retorno | Descrição |
|---|---|
|
FltDetachVolume encontrou uma instância correspondente, mas a instância está sendo interrompida. Este é um código de erro. |
|
Nenhuma instância correspondente foi encontrada. Este é um código de erro. |
Observações
FltDetachVolume desanexa uma instância de driver de minifiltro de um volume e rasga 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 |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| IRQL | <= APC_LEVEL |