Funzione FltGetVolumeFromFileObject (fltkernel.h)

Articolo
08/07/2023

La routine FltGetVolumeFromFileObject restituisce un puntatore opaco per il volume in cui risiede un flusso di file specificato.

Sintassi

NTSTATUS FLTAPI FltGetVolumeFromFileObject(
  [in]  PFLT_FILTER  Filter,
  [in]  PFILE_OBJECT FileObject,
  [out] PFLT_VOLUME  *RetVolume
);

Parametri

[in] Filter

Puntatore di filtro opaco per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in] FileObject

Puntatore a oggetti file per un flusso di file che risiede nel volume.

[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

FltGetVolumeFromFileObject restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_FLT_DELETING_OBJECT	Il volume viene eliminato. Si tratta di un codice di errore.
STATUS_INVALID_PARAMETER	Non è stato trovato alcun volume corrispondente. Si tratta di un codice di errore.

Commenti

FltGetVolumeFromFileObject aggiunge un riferimento rundown al puntatore al volume opaco restituito nel parametro RetVolume . Quando questo puntatore non è più necessario, il chiamante deve rilasciarlo chiamando FltObjectDereference. Ogni chiamata riuscita a FltGetVolumeFromFileObject deve quindi corrispondere a una chiamata successiva a FltObjectDereference.

Per ottenere un puntatore all'oggetto dispositivo per un determinato volume, chiamare FltGetDeviceObject.