Funzione FltGetVolumeFromFileObject (fltkernel.h)

Articolo
02/06/2025

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 all'oggetto 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.

Osservazioni

FltGetVolumeFromFileObject 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. Pertanto, ogni chiamata riuscita a FltGetVolumeFromFileObject deve essere confrontata con una chiamata successiva a FltObjectDereference.

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