FsRtlInsertExtraCreateParameter-Funktion (ntifs.h)

Artikel
12/21/2024

Die FsRtlInsertExtraCreateParameter Routine fügt eine zusätzliche Create-Parameter-Kontextstruktur (ECP) in eine ECP-Liste ein.

Syntax

NTSTATUS FsRtlInsertExtraCreateParameter(
  [in, out] PECP_LIST EcpList,
  [in, out] PVOID     EcpContext
);

Parameter

[in, out] EcpList

Zeiger auf die ECP-Listenstruktur, auf die die ECP-Kontextstruktur verweist, auf die durch den EcpContext Parameter verwiesen wird, sollte hinzugefügt werden.

[in, out] EcpContext

Zeiger auf die ECP-Kontextstruktur, die der ECP-Liste hinzugefügt werden soll, verweist auf den EcpList--Parameter.

Rückgabewert

FsRtlInsertExtraCreateParameter gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die angegebene ECP-Kontextstruktur wurde erfolgreich in die angegebene ECP-Liste eingefügt.
STATUS_INVALID_PARAMETER	Die angegebene ECP-Kontextstruktur ist bereits in der angegebenen ECP-Liste vorhanden. Im Kontext der ECP-Listeneinfügung werden zwei ECP-Kontextstrukturen als identisch betrachtet, wenn sie gleiche GUID-Werte enthalten.

Bemerkungen

Die FsRtlInsertExtraCreateParameter Routine geht davon aus, dass die angegebene ECP-Kontextstruktur, die in die angegebene ECP-Liste eingefügt werden soll, zuvor von der FltAllocateExtraCreateParameter Routine zugeordnet wurde.

Jede in die ECP-Liste eingefügte ECP-Kontextstruktur muss über einen eindeutigen GUID-Wert verfügen. Dieser eindeutige Wert wird festgelegt, wenn die ECP-Kontextstruktur von der FltAllocateExtraCreateParameter Routine zugeordnet wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Die FltInsertExtraCreateParameter-Routine ist ab Windows Vista verfügbar.
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL