Funzione FltGetFilterFromInstance (fltkernel.h)
La routine FltGetFilterFromInstance restituisce un puntatore di filtro opaco per il driver minifilter che ha creato l'istanza specificata.
Sintassi
NTSTATUS FLTAPI FltGetFilterFromInstance(
[in] PFLT_INSTANCE Instance,
[out] PFLT_FILTER *RetFilter
);
Parametri
[in] Instance
Puntatore istanza opaca per l'istanza.
[out] RetFilter
Puntatore a una variabile allocata dal chiamante che riceve un puntatore di filtro opaco per il driver minifilter. Questo parametro è obbligatorio e non può essere NULL.
Valore restituito
FltGetFilterFromInstance restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio quanto segue:
| Codice restituito | Descrizione |
|---|---|
|
Il driver minifilter viene distrutto. Si tratta di un codice di errore. |
Commenti
FltGetFilterFromInstance aggiunge un riferimento di rundown al puntatore del filtro opaco restituito nel parametro RetFilter . Quando questo puntatore non è più necessario, il chiamante deve rilasciarlo chiamando FltObjectDereference. Pertanto ogni chiamata riuscita a FltGetFilterFromInstance deve essere corrispondente a una chiamata successiva a FltObjectDereference.
Per ottenere un puntatore del volume opaco per il volume a cui è associata un'istanza del driver minifilter specificata, chiamare FltGetVolumeFromInstance.
Per enumerare tutte le istanze di un determinato driver minifilter, chiamare FltEnumerateInstanceInstanceInformationByFilter.
Per enumerare le istanze di tutti i driver minifilter in tutti i volumi, chiamare FltEnumerateInstances.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | fltkernel.h (includere Fltkernel.h) |
| Libreria | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |