Fungsi FsRtlFindExtraCreateParameter (ntifs.h)

Artikel
02/26/2024

Rutinitas FsRtlFindExtraCreateParameter mencari daftar ECP tertentu untuk struktur konteks ECP dari jenis tertentu dan mengembalikan pointer ke struktur ini jika ditemukan.

Sintaks

NTSTATUS FsRtlFindExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out, optional] PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

Parameter

[in] EcpList

Penunjuk ke struktur daftar ECP yang digunakan FsRtlFindExtraCreateParameter untuk mencari struktur konteks ECP, yang disediakan oleh parameter EcpType .

[in] EcpType

Penunjuk ke GUID yang secara unik mengidentifikasi struktur konteks ECP. Nilai GUID ini digunakan oleh rutinitas FsRtlFindExtraCreateParamter untuk menentukan apakah struktur konteks ECP ada dalam daftar ECP, yang disediakan 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 FsRtlFindExtraCreateParamter 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, EcpContextSize diatur ke nol.

Nilai kembali

FsRtlFindExtraCreateParameter mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	FsRtlFindExtraCreateParameter menemukan struktur konteks ECP yang ditentukan dalam daftar ECP yang ditentukan.
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter tidak menemukan struktur konteks ECP yang ditentukan dalam daftar ECP yang ditentukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas FsRtlFindExtraCreateParameter tersedia dimulai dengan Windows Vista.
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL