Fungsi FsRtlRemoveExtraCreateParameter (ntifs.h)

Artikel
02/29/2024

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

Sintaks

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

Parameter

[in, out] EcpList

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

[in] EcpType

Pointer ke GUID 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

FsRtlRemoveExtraCreateParameter mengembalikan kode NTSTATUS seperti salah satu hal 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

FsRtlRemoveExtraCreateParameter 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, FsRtlRemoveExtraCreateParameter mencopot struktur dari daftar, mengatur parameter EcpContext untuk menunjuk ke struktur, dan mengembalikan STATUS_SUCCESS. Jika struktur konteks ECP tidak ada dalam daftar, FsRtlRemoveExtraCreateParameter mengatur parameter EcpContext ke NULL dan mengembalikan STATUS_NOT_FOUND.

Catatan

FsRtlRemoveExtraCreateParameter tidak membebaskan kumpulan memori untuk struktur konteks ECP. Untuk membebaskan kumpulan memori untuk struktur konteks ECP, pertama-tama panggil FsRtlRemoveExtraCreateParameter untuk melepaskannya dari daftar lalu panggil rutinitas FltFreeExtraCreateParameter untuk membebaskan kumpulan memori untuk struktur konteks ECP.

Persyaratan

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