Fungsi FltGetVolumeFromInstance (fltkernel.h)
Rutinitas FltGetVolumeFromInstance mengembalikan pointer buram untuk volume yang dilampirkan instans driver minifilter tertentu.
Sintaks
NTSTATUS FLTAPI FltGetVolumeFromInstance(
[in] PFLT_INSTANCE Instance,
[out] PFLT_VOLUME *RetVolume
);
Parameter
[in] Instance
Penunjuk instans buram untuk instans.
[out] RetVolume
Penunjuk ke variabel yang dialokasikan penelepon yang menerima penunjuk buram untuk volume. Parameter ini diperlukan dan tidak boleh NULL.
Nilai kembali
FltGetVolumeFromInstance mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai, seperti berikut ini:
| Menampilkan kode | Deskripsi |
|---|---|
|
Volume tempat instans driver minifilter dilampirkan sedang dirobohkan. Ini adalah kode kesalahan. |
Keterangan
FltGetVolumeFromInstance 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 FltGetVolumeFromInstance harus dicocokkan dengan panggilan berikutnya ke FltObjectDereference.
Untuk mendapatkan penunjuk filter buram untuk driver minifilter yang membuat instans tertentu, panggil FltGetFilterFromInstance.
Untuk mendapatkan pointer ke objek perangkat untuk volume tertentu, panggil FltGetDeviceObject.
Untuk mendapatkan informasi terperinci tentang volume tempat instans tertentu dilampirkan, panggil FltQueryVolumeInformation.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | fltkernel.h (termasuk Fltkernel.h) |
| Pustaka | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |