Função FltRegisterFilter (fltkernel.h)

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 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 por chamador que recebe um ponteiro de filtro opaco para o chamador.

Valor retornado

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 registro foi definida como um valor inválido. Os membros GenerateFileNameCallback, NormalizeNameComponentCallback e NormalizeNameComponentExCallback de FLT_REGISTRATION apontam para as rotinas de 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 é 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 enquanto o driver de minifiltro é 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

   
Plataforma de Destino Universal
Cabeçalho fltkernel.h (include Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Confira também

FLT_REGISTRATION

FltStartFiltering

FltUnregisterFilter