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 de UNICODE_STRING que contém o nome do serviço de driver de minifiltro que foi passado para FltLoadFilter.
Valor de retorno
FltUnloadFilter retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:
| Código de retorno | Descrição |
|---|---|
|
Um motorista de minifiltro correspondente foi encontrado, mas já está sendo derrubado. Este é um código de erro. |
|
Nenhum motorista de minifiltro correspondente foi encontrado. Este é um código de erro. |
Observações
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 à FilterName fornecida e chama a rotina FilterUnloadCallback do driver de minifiltro (PFLT_FILTER_UNLOAD_CALLBACK).
Se o driver de minifiltro de suporte não registrou uma rotina de FilterUnloadCallback, a chamada para FltUnloadFilter falhará.
Um driver de minifiltro não pode chamar FltUnloadFilter para se descarregar.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |