Fungsi FltGetVolumeFromDeviceObject (fltkernel.h)

Artikel
02/26/2024

Rutinitas FltGetVolumeFromDeviceObject mengembalikan pointer buram untuk volume yang diwakili oleh objek perangkat volume (VDO).

Sintaks

NTSTATUS FLTAPI FltGetVolumeFromDeviceObject(
  [in]  PFLT_FILTER    Filter,
  [in]  PDEVICE_OBJECT DeviceObject,
  [out] PFLT_VOLUME    *RetVolume
);

Parameter

[in] Filter

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

[in] DeviceObject

Arahkan ke objek perangkat volume.

[out] RetVolume

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

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_FLT_DELETING_OBJECT	Volume sedang dikoyak. Ini adalah kode kesalahan.
STATUS_INVALID_PARAMETER	Objek perangkat volume yang ditentukan dalam parameter DeviceObject bukan penunjuk objek perangkat volume yang valid, atau tidak ada volume yang cocok yang ditemukan. Ini adalah kode kesalahan.

Keterangan

Parameter DeviceObject dapat menjadi penunjuk ke filter atau objek perangkat volume sistem file (VDO). Jika menunjuk ke objek perangkat penyimpanan, FltGetVolumeFromDeviceObject mengembalikan STATUS_INVALID_PARAMETER.

Untuk informasi selengkapnya tentang objek perangkat volume, lihat Tumpukan Sistem File.

FltGetVolumeFromDeviceObject menambahkan referensi rundown ke penunjuk 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 FltGetVolumeFromDeviceObject harus dicocokkan dengan panggilan berikutnya ke FltObjectDereference.

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