Fungsi FltGetFilterFromInstance (fltkernel.h)

Rutinitas FltGetFilterFromInstance mengembalikan penunjuk filter buram untuk driver minifilter yang membuat instans tertentu.

Sintaks

NTSTATUS FLTAPI FltGetFilterFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_FILTER   *RetFilter
);

Parameter

[in] Instance

Penunjuk instans buram untuk instans.

[out] RetFilter

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

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_FLT_DELETING_OBJECT	Sopir minifilter sedang dirobohkan. Ini adalah kode kesalahan.

Keterangan

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

Untuk mendapatkan penunjuk volume buram untuk volume tempat instans driver minifilter tertentu terpasang, panggil FltGetVolumeFromInstance.

Untuk menghitung semua instans driver minifilter tertentu, panggil FltEnumerateInstanceInformationByFilter.

Untuk menghitung instans semua driver minifilter pada semua volume, panggil FltEnumerateInstances.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

Lihat juga

FltEnumerateInstanceInformationByFilter

FltEnumerateInstances

FltGetVolumeFromInstance

FltObjectDereference