Função FltUnloadFilter (fltkernel.h)

Um driver de minifiltro que carregou um driver de minifiltro de suporte chamando FltLoadFilter pode descarregar o driver de minifiltro chamando FltUnloadFilter.

Sintaxe

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

Parâmetros

[in] FilterName

Ponteiro para uma estrutura UNICODE_STRING que contém o nome do serviço de driver de minifiltro que foi passado para FltLoadFilter.

Valor retornado

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

Código de retorno Descrição
STATUS_FLT_DELETING_OBJECT
Um motorista de minifiltro correspondente foi encontrado, mas já está sendo derrubado. Este é um código de erro.
STATUS_FLT_FILTER_NOT_FOUND
Nenhum driver de minifiltro correspondente foi encontrado. Este é um código de erro.

Comentários

Um driver de minifiltro que tem uma dependência em outro driver de minifiltro pode descarregar esse driver de minifiltro chamando FltUnloadFilter. Essa rotina procura um driver de minifiltro registrado cujo nome de serviço corresponde ao FilterName fornecido e chama a rotina FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) do driver de minifiltro.

Se o driver de minifiltro de suporte não registrou uma rotina FilterUnloadCallback , a chamada para FltUnloadFilter falhará.

Um driver de minifiltro não pode chamar FltUnloadFilter para se descarregar.

Requisitos

   
Plataforma de Destino Universal
Cabeçalho fltkernel.h (include Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Confira também

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING