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
STATUS_FLT_DELETING_OBJECT	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

Lihat juga

FltGetDeviceObject

FltGetFilterFromInstance

FltObjectDereference

FltQueryVolumeInformation