Funzione FltGetFilterFromName (fltkernel.h)

Articolo
03/05/2024

La routine FltGetFilterFromName restituisce un puntatore di filtro opaco per un driver minifilter 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 minifilter. 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 minifilter 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.

Commenti

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. Ogni chiamata a FltGetFilterFromName deve quindi corrispondere a una chiamata successiva a FltObjectDereference.

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