Funzione FltGetFilterFromName (fltkernel.h)

Articolo
02/06/2025

La routine FltGetFilterFromName restituisce un puntatore di filtro opaco per un driver minifiltro registrato il cui nome corrisponde al valore nel parametro FilterName.

Sintassi

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

Parametri

[in] FilterName

Puntatore a una struttura UNICODE_STRING contenente il nome del driver minifiltro. Il confronto dei nomi non fa distinzione tra maiuscole e minuscole.

[out] RetFilter

Puntatore a una variabile allocata dal chiamante che riceve un puntatore di filtro opaco per il driver minifilter il cui nome corrisponde al nome nel parametro FilterName. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FltGetFilterFromName restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_FLT_DELETING_OBJECT	È stato trovato un driver minifiltro corrispondente, ma viene eliminato. Si tratta di un codice di errore.
STATUS_FLT_FILTER_NOT_FOUND	Non è stato trovato alcun driver minifilter corrispondente. Si tratta di un codice di errore.

Osservazioni

FltGetFilterFromName aggiunge un riferimento rundown al puntatore di filtro opaco restituito nel parametro RetFilter. Quando questo puntatore non è più necessario, il chiamante deve rilasciarlo chiamando FltObjectDereference. Pertanto, ogni chiamata riuscita a FltGetFilterFromName deve essere confrontata con una chiamata successiva a FltObjectDereference.

Per registrare un driver minifiltro con Gestione filtri, chiamare FltRegisterFilter.