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.

Retornar valor

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.

Comentários

Um driver de minifiltro normalmente chama FltStartFiltering de sua rotina 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
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Confira também

FltRegisterFilter