Função FltGetFilterFromName (fltkernel.h)

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 por 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.

Valor de retorno

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

Observações

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.

Requisitos

Consulte também

FltObjectDereference

FltRegisterFilter

UNICODE_STRING