Fungsi FltRemoveExtraCreateParameter (fltkernel.h)

Artikel
02/29/2024

FltRemoveExtraCreateParameter rutin mencari daftar ECP untuk struktur konteks ECP dan, jika ditemukan, melepaskannya dari daftar ECP.

Sintaks

NTSTATUS FLTAPI FltRemoveExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in, out]       PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out]           PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

Parameter

[in] Filter

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

[in, out] EcpList

Arahkan ke daftar parameter buat ekstra (ECP) yang berisi struktur konteks ECP yang akan dilepas dari daftar yang diberikan.

[in] EcpType

Penunjuk ke GUID yang ditentukan pengguna yang secara unik mengidentifikasi struktur konteks ECP yang akan dilepas dari daftar.

[out] EcpContext

Arahkan ke struktur konteks ECP yang dilepas. Jika struktur konteks ECP berhasil dilepas dari daftar yang diberikan, parameter ini akan diatur untuk menunjuk ke struktur konteks ECP yang dilepaskan. Jika struktur konteks ECP tidak ditemukan dalam daftar ECP yang diberikan, parameter ini diatur ke NULL.

[out, optional] EcpContextSize

Parameter opsional yang menerima ukuran struktur konteks ECP yang dilepas. Jika parameter ini ada ketika rutinitas dipanggil, parameter akan menerima ukuran, dalam byte, dari struktur konteks ECP yang terlepas. Jika struktur konteks ECP yang diberikan tidak ditemukan dalam daftar ECP yang diberikan, parameter ini tidak terdefinisi.

Nilai kembali

FltRemoveExtraCreateParameter mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Struktur konteks ECP yang diberikan berhasil dilepas dari daftar ECP yang diberikan.
STATUS_NOT_FOUND	Struktur konteks ECP yang diberikan tidak ditemukan dalam daftar ECP yang diberikan.

Keterangan

FltRemoveExtraCreateParameter rutin mencari daftar ECP yang diberikan oleh parameter EcpList untuk struktur konteks ECP yang diberikan oleh parameter EcpType. Jika struktur konteks ECP ada dalam daftar, struktur tersebut dilepas dari daftar, parameter EcpContext diatur untuk menunjuk ke dalamnya, dan rutin mengembalikan STATUS_SUCCESS. Jika struktur konteks ECP tidak ada dalam daftar, parameter EcpContext diatur ke NULL dan rutin mengembalikan STATUS_NOT_FOUND.

Catatan Rutinitas ini tidak membebaskan kumpulan memori untuk struktur konteks ECP. Untuk membebaskan struktur konteks ECP, pertama-tama panggil rutinitas ini untuk melepaskannya dari daftar dan kemudian panggil rutinitas FltFreeExtraCreateParameter untuk membebaskan struktur konteks ECP itu sendiri.

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