Fungsi FltFindExtraCreateParameter (fltkernel.h)

Artikel
08/07/2023

FltFindExtraCreateParameter rutin mencari daftar ECP tertentu untuk struktur konteks ECP dari jenis tertentu dan mengembalikan penunjuk ke struktur ini jika ditemukan.

Sintaks

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] 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] EcpList

Arahkan ke struktur daftar ECP untuk mencari struktur konteks ECP (diberikan oleh parameter EcpType ).

[in] EcpType

Pointer ke GUID yang secara unik mengidentifikasi setiap struktur konteks ECP. Nilai GUID ini digunakan oleh rutinitas FltFindExtraCreateParamter untuk menentukan apakah struktur konteks ECP ada dalam daftar ECP (diberikan oleh parameter EcpList ).

[out, optional] EcpContext

Parameter opsional yang menerima penunjuk ke struktur konteks ECP yang ditemukan. Jika struktur konteks ECP tidak ditemukan dalam daftar ECP, EcpContext diatur ke NULL. Jika EcpContext diatur ke NULL oleh pemanggil, nilai pengembalian rutinitas ini dapat digunakan untuk menentukan apakah struktur konteks ECP ada dalam daftar ECP.

[out, optional] EcpContextSize

Parameter opsional yang menerima ukuran, dalam byte, dari struktur konteks ECP yang ditemukan. Jika struktur konteks ECP tidak ditemukan dalam daftar ECP, EcpContextSize diatur ke nol.

Nilai kembali

FltFindExtraCreateParameter mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Struktur konteks ECP (seperti yang ditentukan oleh parameter EcpType ) ditemukan dalam daftar ECP (seperti yang ditentukan oleh parameter EcpList ).
STATUS_NOT_FOUND	Struktur konteks ECP (seperti yang ditentukan oleh parameter EcpType ) tidak ditemukan dalam daftar ECP (seperti yang ditentukan oleh parameter EcpList ).

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