Fungsi FltGetDeviceObject (fltkernel.h)

Artikel
02/26/2024

Rutinitas FltGetDeviceObject mengembalikan pointer ke objek perangkat volume (VDO) Manajer Filter untuk volume tertentu.

Sintaks

NTSTATUS FLTAPI FltGetDeviceObject(
  [in]  PFLT_VOLUME    Volume,
  [out] PDEVICE_OBJECT *DeviceObject
);

Parameter

[in] Volume

Penunjuk buram untuk volume.

[out] DeviceObject

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

Nilai kembali

FltGetDeviceObject mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti berikut ini:

Menampilkan kode	Deskripsi
STATUS_FLT_NO_DEVICE_OBJECT	Objek perangkat yang diminta tidak ada untuk volume yang diberikan. Ini adalah kode kesalahan.

Keterangan

FltGetDeviceObject mengembalikan pointer ke objek perangkat volume (VDO) Manajer Filter untuk volume yang diberikan.

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

VDO Manajer Filter tidak sama dengan objek perangkat disk driver penyimpanan dasar atau VDO sistem file dasar. Untuk mendapatkan penunjuk ke objek perangkat disk, panggil FltGetDiskDeviceObject pada volume yang ditentukan dalam parameter Volume . Untuk mendapatkan pointer ke VDO sistem file dasar, panggil IoGetDeviceAttachmentBaseRef pada RetDeviceObject yang dikembalikan oleh FltGetDeviceObject.

Untuk mendapatkan pointer buram untuk volume yang sesuai untuk objek perangkat tertentu, panggil FltGetVolumeFromDeviceObject.

FltGetDeviceObject menaikkan jumlah referensi pada penunjuk objek perangkat yang dikembalikan. Ketika pointer ini tidak lagi diperlukan, pemanggil harus mengurangi jumlah referensi ini dengan memanggil ObDereferenceObject. Dengan demikian setiap panggilan yang berhasil ke FltGetDeviceObject harus dicocokkan dengan panggilan berikutnya ke ObDereferenceObject.