Fungsi FltGetEcpListFromCallbackData (fltkernel.h)

Artikel
02/27/2024

Rutinitas FltGetEcpListFromCallbackData mengembalikan penunjuk ke daftar struktur konteks parameter buat tambahan (ECP) yang terkait dengan objek callback-data operasi pembuatan tertentu.

Sintaks

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] 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

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

[out] EcpList

Menerima penunjuk ke daftar ECP yang terkait dengan objek callback-data CallbackData .

Nilai kembali

FltGetEcpListFromCallbackData mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	EcpList menerima penunjuk ke daftar ECP yang terkait dengan objek callback-data yang diberikan. Jika objek callback-data tidak memiliki ECP terkait, STATUS_SUCCESS dikembalikan dan EcpList adalah NULL.
STATUS_INVALID_PARAMETER	Objek callback-data yang diberikan bukan operasi pembuatan berbasis IRP. Dalam hal ini, EcpList tidak terdefinisi.

Keterangan

Untuk melampirkan daftar ECP ke objek callback-data, gunakan rutinitas FltSetEcpListIntoCallbackData .

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