FsRtlInsertExtraCreateParameter 函数 (ntifs.h)

FsRtlInsertExtraCreateParameter 例程 (ECP) 上下文结构插入额外的 create 参数到 ECP 列表中。

语法

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

[in, out] EcpList

指向 ECP 列表结构的指针， EcpContext 参数所指向的 ECP 上下文结构应添加到该结构。

[in, out] EcpContext

指向要添加到 ECP 列表的 ECP 上下文结构的指针，由 EcpList 参数指向。

FsRtlInsertExtraCreateParameter 返回以下 NTSTATUS 值之一：

返回代码	说明
STATUS_SUCCESS	给定的 ECP 上下文结构已成功插入到给定的 ECP 列表中。
STATUS_INVALID_PARAMETER	给定的 ECP 上下文结构已存在于给定的 ECP 列表中。在 ECP 列表插入的上下文中，如果两个 ECP 上下文结构包含相等的 GUID 值，则认为它们相同。

FsRtlInsertExtraCreateParameter 例程假定要插入给定 ECP 列表的给定 ECP 上下文结构以前由 FltAllocateExtraCreateParameter 例程分配。

插入到 ECP 列表中的每个 ECP 上下文结构必须具有唯一的 GUID 值。当 ECP 上下文结构由 FltAllocateExtraCreateParameter 例程分配时，将设置此唯一值。

要求	值
最低受支持的客户端	FltInsertExtraCreateParameter 例程从 Windows Vista 开始可用。
目标平台	通用
标头	ntifs.h (包括 Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL