Função FltGetFilterFromName (fltkernel.h)

Artigo
02/26/2024

A rotina FltGetFilterFromName retorna um ponteiro de filtro opaco para um driver de minifiltro registrado cujo nome corresponde ao valor no parâmetro FilterName .

Sintaxe

NTSTATUS FLTAPI FltGetFilterFromName(
  [in]  PCUNICODE_STRING FilterName,
  [out] PFLT_FILTER      *RetFilter
);

Parâmetros

[in] FilterName

Ponteiro para uma estrutura UNICODE_STRING que contém o nome do driver de minifiltro. (A comparação de nomes não diferencia maiúsculas de minúsculas.)

[out] RetFilter

Ponteiro para uma variável alocada pelo chamador que recebe um ponteiro de filtro opaco para o driver de minifiltro cujo nome corresponde ao nome no parâmetro FilterName . Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

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

Código de retorno	Descrição
STATUS_FLT_DELETING_OBJECT	Um motorista de minifiltro correspondente foi encontrado, mas está sendo derrubado. Este é um código de erro.
STATUS_FLT_FILTER_NOT_FOUND	Nenhum driver de minifiltro correspondente foi encontrado. Este é um código de erro.

Comentários

FltGetFilterFromName adiciona uma referência de rundown ao ponteiro de filtro opaco retornado no parâmetro RetFilter . Quando esse ponteiro não for mais necessário, o chamador deverá liberá-lo chamando FltObjectDereference. Portanto, cada chamada bem-sucedida para FltGetFilterFromName deve ser correspondida por uma chamada subsequente para FltObjectDereference.

Para registrar um driver de minifiltro com o Gerenciador de Filtros, chame FltRegisterFilter.