Fungsi FltSetEcpListIntoCallbackData (fltkernel.h)

Artikel
02/29/2024

Rutinitas FltSetEcpListIntoCallbackData melampirkan daftar struktur konteks parameter buat tambahan (ECP) ke objek buat data panggilan balik operasi.

Sintaks

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

Parameter

[in] Filter

Penunjuk filter buram ke driver minifilter. Pointer ini secara unik mengidentifikasi driver minifilter dan tetap konstan selama driver minifilter dimuat.

CallbackData

Penunjuk ke objek callback-data jenis FLT_CALLBACK_DATA, yang mewakili operasi buat.

[in] EcpList

Penunjuk ke daftar ECP, yang berisi satu atau beberapa ECP, untuk dilampirkan ke objek callback-data.

Nilai kembali

FltSetEcpListIntoCallbackData mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Daftar ECP yang diberikan berhasil dilampirkan ke objek callback-data yang diberikan.
STATUS_INVALID_PARAMETER_2	Objek data panggilan balik yang diberikan bukan operasi pembuatan berbasis IRP.
STATUS_INVALID_PARAMETER_3	Daftar ECP telah dilampirkan ke objek callback-data yang diberikan.

Keterangan

Rutinitas FltSetEcpListIntoCallbackData menyediakan mekanisme untuk meneruskan parameter pembuatan ekstra ke tumpukan filter sistem file ke minifilter yang mendasari dan driver filter warisan.

Untuk mengambil daftar ECP terlampir dari objek callback-data tertentu, gunakan rutinitas FltGetEcpListFromCallbackData .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas ini tersedia dimulai dengan Windows Vista.
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL