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

Vedi anche

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation