Compartilhar via


Função FltStartFiltering (fltkernel.h)

FltStartFiltering inicia a filtragem para um driver de minifiltro registrado.

Sintaxe

NTSTATUS FLTAPI FltStartFiltering(
  [in] PFLT_FILTER Filter
);

Parâmetros

[in] Filter

Ponteiro de filtro opaco retornado por FltRegisterFilter.

Valor de retorno

FltStartFiltering retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno Descrição
STATUS_INVALID_PARAMETER
A filtragem já foi iniciada para esse driver de minifiltro. Este é um código de erro.

Observações

Um driver de minifiltro normalmente chama FltStartFiltering de sua rotina de DriverEntry depois de concluir sua inicialização global e chamar FltRegisterFilter. FltStartFiltering notifica o Gerenciador de Filtros de que o driver de minifiltro está pronto para começar a anexar a volumes e filtrar solicitações de E/S. Depois que o driver de minifiltro chama essa rotina, o Gerenciador de Filtros trata o driver de minifiltro como um driver de minifiltro totalmente ativo, apresentando-o com volumes a serem anexados, bem como solicitações de E/S. O driver de minifiltro deve estar preparado para começar a receber essas notificações e solicitações de E/S antes mesmo de fltStartFiltering retornar.

Requisitos

Requisito Valor
da Plataforma de Destino Universal
cabeçalho fltkernel.h (inclua Fltkernel.h)
biblioteca FltMgr.lib
de DLL Fltmgr.sys
IRQL <= APC_LEVEL

Consulte também

FltRegisterFilter