Partager via


FsRtlSetEcpListIntoIrp, fonction (ntifs.h)

La routine FsRtlSetEcpListIntoIrp attache une liste de structure de contexte de paramètre de création supplémentaire (ECP) à une opération de IRP_MJ_CREATE.

Syntaxe

NTSTATUS FsRtlSetEcpListIntoIrp(
  [in, out] PIRP      Irp,
  [in]      PECP_LIST EcpList
);

Paramètres

[in, out] Irp

Pointeur vers l’IRP d’une opération IRP_MJ_CREATE à laquelle la liste de structure de contexte ECP doit être attachée.

[in] EcpList

Pointeur vers une liste ECP qui contient une ou plusieurs structures de contexte ECP. Ces structures sont attachées à l’IRP vers lequel pointe le paramètre Irp .

Valeur retournée

FsRtlSetEcpListIntoIrp retourne l’une des valeurs NTSTATUS suivantes :

Code de retour Description
STATUS_SUCCESS
La liste des PCE donnée a été jointe avec succès à l’IRP donné.
STATUS_INVALID_PARAMETER_2
L’IRP donné n’était pas une opération de IRP_MJ_CREATE basée sur iRP.
STATUS_INVALID_PARAMETER_3
Une liste de PCE a déjà été jointe à l’IRP donné.

Remarques

La routine FsRtlSetEcpListIntoIrp fournit un mécanisme permettant de transmettre des paramètres de création supplémentaires dans la pile de filtres du système de fichiers aux pilotes de filtre sous-jacents.

Pour récupérer une liste ECP associée à une opération de IRP_MJ_CREATE donnée, utilisez la routine FsRtlGetEcpListFromIrp .

Configuration requise

Condition requise Valeur
Client minimal pris en charge FsRtlSetEcpListIntoIrp est disponible à partir de Windows Vista.
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

ECP_LIST

FsRtlGetEcpListFromIrp