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
STATUS_FLT_DELETING_OBJECT	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

Vedi anche

FltEnumerateInstanceInformationByFilter

FltEnumerateInstances

FltGetVolumeFromInstance

FltObjectDereference