Compartilhar via


Função FltLoadFilter (fltkernel.h)

A rotina FltLoadFilter carrega dinamicamente um driver de minifiltro no sistema em execução no momento.

Sintaxe

NTSTATUS FLTAPI FltLoadFilter(
  [in] PCUNICODE_STRING FilterName
);

Parâmetros

[in] FilterName

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

Retornar valor

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

Código de retorno Descrição
STATUS_DRIVER_FAILED_PRIOR_UNLOAD
O driver de minifiltro não pôde ser carregado porque uma versão anterior do driver ainda está na memória. Este é um código de erro.
STATUS_FAILED_DRIVER_ENTRY
A rotina DriverEntry do driver de minifiltro retornou um valor NTSTATUS que não era um código de êxito. Este é um código de erro.
STATUS_IMAGE_ALREADY_LOADED
O driver de minifiltro já está em execução. Este é um código de erro.
STATUS_OBJECT_NAME_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 carregar esse driver de minifiltro chamando FltLoadFilter.

Para descarregar o driver de minifiltro de suporte, chame FltUnloadFilter.

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

FltUnloadFilter

UNICODE_STRING