FsRtlInsertExtraCreateParameter, fonction (ntifs.h)

Article
12/21/2024

La routine FsRtlInsertExtraCreateParameter insère une structure de contexte de paramètre de création supplémentaire (ECP) dans une liste ECP.

Syntaxe

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

Paramètres

[in, out] EcpList

Pointeur vers la structure de liste ECP vers laquelle la structure de contexte ECP, pointée par le paramètre EcpContext, doit être ajouté.

[in, out] EcpContext

Pointeur vers la structure de contexte ECP à ajouter à la liste ECP, pointé par le paramètre EcpList.

Valeur de retour

FsRtlInsertExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Retourner le code	Description
STATUS_SUCCESS	La structure de contexte ECP donnée a été correctement insérée dans la liste ECP donnée.
STATUS_INVALID_PARAMETER	La structure de contexte ECP donnée existe déjà dans la liste ECP donnée. Dans le contexte de l’insertion de liste ECP, deux structures de contexte ECP sont considérées comme identiques si elles contiennent des valeurs GUID égales.

Remarques

La routine FsRtlInsertExtraCreateParameter suppose que la structure de contexte ECP donnée à insérer dans la liste ECP donnée a été précédemment allouée par la routine FltAllocateExtraCreateParameter.

Chaque structure de contexte ECP insérée dans la liste ECP doit avoir une valeur GUID unique. Cette valeur unique est définie lorsque la structure de contexte ECP est allouée par la routine FltAllocateExtraCreateParameter.

Exigences

Exigence	Valeur
client minimum pris en charge	La routine FltInsertExtraCreateParameter est disponible à partir de Windows Vista.
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL