Fungsi FltGetVolumeFromFileObject (fltkernel.h)

Artikel
02/29/2024

Rutinitas FltGetVolumeFromFileObject mengembalikan pointer buram untuk volume tempat aliran file tertentu berada.

Sintaks

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

Parameter

[in] Filter

Penunjuk filter buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk objek file untuk aliran file yang berada pada volume.

[out] RetVolume

Penunjuk ke variabel yang dialokasikan penelepon yang menerima pointer buram untuk volume. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FltGetVolumeFromFileObject mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai, seperti salah satu hal berikut:

Menampilkan kode	Deskripsi
STATUS_FLT_DELETING_OBJECT	Volume sedang dicabik-cabik. Ini adalah kode kesalahan.
STATUS_INVALID_PARAMETER	Tidak ditemukan volume yang cocok. Ini adalah kode kesalahan.

Keterangan

FltGetVolumeFromFileObject menambahkan referensi rundown ke pointer volume buram yang dikembalikan dalam parameter RetVolume . Ketika pointer ini tidak lagi diperlukan, pemanggil harus melepaskannya dengan memanggil FltObjectDereference. Dengan demikian setiap panggilan yang berhasil ke FltGetVolumeFromFileObject harus dicocokkan dengan panggilan berikutnya ke FltObjectDereference.

Untuk mendapatkan pointer ke objek perangkat untuk volume tertentu, panggil FltGetDeviceObject.