Funzione FltGetVolumeFromInstance (fltkernel.h)
La routine FltGetVolumeFromInstance restituisce un puntatore opaco per il volume a cui è collegata un'istanza del driver minifilter specificata.
Sintassi
NTSTATUS FLTAPI FltGetVolumeFromInstance(
[in] PFLT_INSTANCE Instance,
[out] PFLT_VOLUME *RetVolume
);
Parametri
[in] Instance
Puntatore dell'istanza opaca per l'istanza.
[out] RetVolume
Puntatore a una variabile allocata dal chiamante che riceve un puntatore opaco per il volume. Questo parametro è obbligatorio e non può essere NULL.
Valore restituito
FltGetVolumeFromInstance restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio:
| Codice restituito | Descrizione |
|---|---|
|
Il volume a cui è collegata l'istanza del driver minifilter viene eliminato. Si tratta di un codice di errore. |
Commenti
FltGetVolumeFromInstance aggiunge un riferimento di rundown al puntatore al volume opaco restituito nel parametro RetVolume . Quando questo puntatore non è più necessario, il chiamante deve rilasciarlo chiamando FltObjectDereference. Ogni chiamata a FltGetVolumeFromInstance deve quindi corrispondere a una chiamata successiva a FltObjectDereference.
Per ottenere un puntatore di filtro opaco per il driver minifilter che ha creato una determinata istanza, chiamare FltGetFilterFromInstance.
Per ottenere un puntatore all'oggetto dispositivo per un determinato volume, chiamare FltGetDeviceObject.
Per ottenere informazioni dettagliate sul volume a cui è collegata una determinata istanza, chiamare FltQueryVolumeInformation.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | fltkernel.h (include Fltkernel.h) |
| Libreria | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |