Fungsi FltInsertExtraCreateParameter (fltkernel.h)

Artikel
02/26/2024

Rutinitas FltInsertExtraCreateParameter menyisipkan struktur konteks parameter buat ekstra (ECP) ke dalam daftar ECP.

Sintaks

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

Parameter

[in] Filter

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

[in, out] EcpList

Penunjuk ke struktur daftar ECP tempat struktur konteks ECP, yang disediakan oleh parameter EcpContext , harus ditambahkan.

[in, out] EcpContext

Penunjuk ke struktur konteks ECP untuk ditambahkan ke daftar ECP, yang disediakan oleh parameter EcpList .

Nilai kembali

FltInsertExtraCreateParameter mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Struktur konteks ECP yang diberikan berhasil dimasukkan ke dalam daftar ECP yang diberikan.
STATUS_INVALID_PARAMETER	Struktur konteks ECP yang diberikan sudah ada dalam daftar ECP yang diberikan. Dalam konteks penyisipan daftar ECP, dua struktur konteks ECP dianggap identik jika berisi nilai GUID yang sama.

Keterangan

Rutinitas FltInsertExtraCreateParameter mengasumsikan bahwa struktur konteks ECP yang diberikan untuk dimasukkan ke dalam daftar ECP yang diberikan sebelumnya dialokasikan oleh rutinitas FltAllocateExtraCreateParameter .

Setiap struktur konteks ECP yang dimasukkan ke dalam daftar ECP harus memiliki nilai GUID yang unik. Nilai unik ini ditetapkan ketika struktur konteks ECP dialokasikan oleh rutinitas FltAllocateExtraCreateParameter .

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