Função FltUnloadFilter (fltkernel.h)

  • Artigo

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 do driver de minifiltro que foi passado para FltLoadFilter.

Retornar valor

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

Código de retorno Descrição
STATUS_FLT_DELETING_OBJECT
 Um minifiltro correspondente foi encontrado, mas já está sendo destruído. 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

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

Confira também

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING