Função FltRegisterFilter (fltkernel.h)

  • Artigo

FltRegisterFilter registra um driver de minifiltro.

Sintaxe

NTSTATUS FLTAPI FltRegisterFilter(
  [in]  PDRIVER_OBJECT         Driver,
  [in]  const FLT_REGISTRATION *Registration,
  [out] PFLT_FILTER            *RetFilter
);

Parâmetros

[in] Driver

Um ponteiro para o objeto de driver para o driver de minifiltro. Esse deve ser o mesmo ponteiro de objeto de driver que foi passado como entrada para a rotina DriverEntry do driver de minifiltro.

[in] Registration

Um ponteiro para uma estrutura de registro de driver de minifiltro alocado pelo chamador (FLT_REGISTRATION).

[out] RetFilter

Um ponteiro para uma variável alocada pelo chamador que recebe um ponteiro de filtro opaco para o chamador.

Retornar valor

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

Código de retorno Descrição
STATUS_INSUFFICIENT_RESOURCES
 FltRegisterFilter encontrou uma falha de alocação de pool. Este é um código de erro.
STATUS_INVALID_PARAMETER
 Um dos seguintes:
  • O membro Version da estrutura Registro não foi definido como FLT_REGISTRATION_VERSION.
  • Uma das rotinas de provedor de nomes não NULL na estrutura De registro foi definida como um valor inválido. Os membros GenerateFileNameCallback, NormalizeNameComponentCallback e NormalizeNameComponentExCallback de FLT_REGISTRATION apontam para as rotinas do provedor de nomes.
STATUS_INVALID_PARAMETER é um código de erro.
STATUS_FLT_NOT_INITIALIZED
 O Gerenciador de Filtros não foi inicializado quando o filtro tentou se registrar. Verifique se o Gerenciador de Filtros está carregado como um driver. Este é um código de erro.
STATUS_OBJECT_NAME_NOT_FOUND
 A chave de serviço de filtro não foi encontrada no Registro.

-ou-

A instância de filtro não está registrada.

Comentários

Cada driver de minifiltro deve chamar FltRegisterFilter de sua rotina DriverEntry para se adicionar à lista global de drivers de minifiltro registrados e fornecer ao Gerenciador de Filtros uma lista de funções de retorno de chamada e outras informações sobre o driver de minifiltro.

FltRegisterFilter retorna um ponteiro de filtro opaco para o driver de minifiltro em *RetFilter. Esse valor de ponteiro identifica exclusivamente o driver de minifiltro e permanece constante desde que o driver de minifiltro seja carregado. O driver de minifiltro deve salvar esse ponteiro, pois ele é um parâmetro necessário para FltStartFiltering e FltUnregisterFilter.

Depois de chamar FltRegisterFilter, um driver de minifiltro normalmente chama FltStartFiltering para começar a filtrar operações de E/S.

Um driver de minifiltro só pode chamar FltRegisterFilter para se registrar, não outro driver de minifiltro.

Para cancelar o registro em si, um driver de minifiltro chama FltUnregisterFilter..

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

FLT_REGISTRATION

FltStartFiltering

FltUnregisterFilter