Fungsi FltGetNextExtraCreateParameter (fltkernel.h)

Artikel
08/07/2023

Rutinitas FltGetNextExtraCreateParameter mengembalikan penunjuk ke struktur konteks parameter buat tambahan (ECP) berikutnya (atau pertama) dalam daftar ECP tertentu.

Sintaks

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

Parameter

[in] Filter

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

[in] EcpList

Arahkan ke daftar ECP untuk diperiksa.

[in, optional] CurrentEcpContext

Penunjuk opsional ke ECP dalam daftar ECP yang diberikan. Jika ada, FltGetNextExtraCreateParameter mengembalikan ECP setelah CURRENTEcpContext ECP. Jika CurrentEcpContext adalah NULL, FltGetNextExtraCreateParameter mengembalikan ECP pertama dalam daftar.

[out, optional] NextEcpType

Parameter opsional yang menerima pointer ke GUID ECP yang dikembalikan.

[out, optional] NextEcpContext

Parameter opsional yang menerima pointer ke ECP yang dikembalikan.

[out, optional] NextEcpContextSize

Parameter opsional yang menerima ukuran, dalam byte, dari ECP yang dikembalikan.

Nilai kembali

FltGetNextExtraCreateParameter mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	ECP ditemukan dalam daftar ECP EcpList .
STATUS_NOT_FOUND	Daftar ECP EcpList kosong atau CurrentEcpContext adalah ECP terakhir dalam daftar yaitu, tidak ada elemen daftar ECP berikutnya). Selain itu, NextEcpContext diatur ke NULL dan NextEcpContextSize diatur ke nol.
STATUS_INVALID_PARAMETER	Parameter EcpList adalah NULL.

Keterangan

Rutinitas ini tersedia dimulai dengan Windows Vista.

FltGetNextExtraCreateParameter rutin memproses daftar ECP dengan cara yang tidak melingkar. Artinya, jika ECP yang diarahkan oleh parameter CurrentEcpContext adalah elemen ECP terakhir dalam daftar ECP, tidak ada ECP "berikutnya" dalam daftar dan rutin mengembalikan STATUS_NOT_FOUND.

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