FsRtlAllocateExtraCreateParameter 函数（ntifs.h）

项目
12/21/2024

FsRtlAllocateExtraCreateParameter 例程为额外的创建参数（ECP）上下文结构分配内存，并生成指向该结构的指针。

语法

NTSTATUS FsRtlAllocateExtraCreateParameter(
  [in]           LPCGUID                                        EcpType,
  [in]           ULONG                                          SizeOfContext,
  [in]           FSRTL_ALLOCATE_ECP_FLAGS                       Flags,
  [in, optional] PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK CleanupCallback,
  [in]           ULONG                                          PoolTag,
  [out]          PVOID                                          *EcpContext
);

参数

[in] EcpType

指向指示 ECP 上下文结构的类型的 GUID 的指针。有关详细信息，请参阅在驱动程序中使用 GUID。

[in] SizeOfContext

上下文结构的大小（以字节为单位）。

[in] Flags

定义池分配选项。下面介绍了在使用按位 OR 操作将一个或多个列出的标志值与 Flags 参数结合使用时如何分配池：

FSRTL_ALLOCATE_ECP_FLAG_NONPAGED_POOL - 将分配非分页池。如果未使用此标志值，则会分配分页池。
FSRTL_ALLOCATE_ECPLIST_FLAG_CHARGE_QUOTA - 由 FsRtlAllocateExtraCreateParameter 分配的所有池将针对当前进程的内存配额收费。

如果使用多个标志，将发生与已利用的标志值关联的所有效果。

[in, optional] CleanupCallback

指向 PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK类型的筛选器定义的清理回调例程的可选指针。删除 ecP 结构（由 FsRtlAllocateExtraCreateParameter 例程创建）时，将调用清理回调例程。如果清理回调例程不适用，请将此参数设置为 NULL。

[in] PoolTag

指定已分配内存的池标记。有关详细信息，请参阅 ExAllocatePoolWithTag的 Tag 参数。

[out] EcpContext

接收指向分配的 ECP 上下文结构的指针。如果例程未能分配足够的池，则 EcpContext 指向的值将 NULL，FsRtlAllocateExtraCreateParameter 将返回状态代码STATUS_INSUFFICIENT_RESOURCES。

返回值

FltAllocateExtraCreateParameter 返回状态代码，如下所示：

返回代码	描述
STATUS_INSUFFICIENT_RESOURCES	FsRtlAllocateExtraCreateParameter 无法为 ECP 结构分配足够的内存。在这种情况下，EcpContext 为 NULL。
STATUS_SUCCESS	已成功分配 ECP 结构。在这种情况下，EcpContext 参数中返回指向已分配结构的指针。

言论

默认情况下，FsRtlAllocateExtraCreateParameter 例程为 ECP 上下文结构分配分页内存池。如果FSRTL_ALLOCATE_ECP_FLAG_NONPAGED_POOL位掩码按标志参数中所述使用，则会分配非分页内存池。分配此池并初始化 ECP 上下文结构后，FltInsertExtraCreateParameter 例程用于将 ECP 上下文结构（ECP 列表元素）插入 ECP 列表结构（ECP_LIST）。

如果调用方在调用 IoCreateFileEx中使用了ECP_LIST和一个或多个 ECP，则前面的说明是正确的。在这种情况下，系统不会释放任何 ECP，因此调用方可以使用同一 ECP 集 IoCreateFileEx 进行多个调用。但是，如果文件系统或文件系统筛选器驱动程序在处理IRP_MJ_CREATE请求时将 ECP 附加到现有或新创建的ECP_LIST，则在 IRP 完成时会自动清理此 ECP。因此，筛选器驱动程序不必清理动态添加的 ECP。这允许筛选器驱动程序的 ECP 在重新分析点之间正确传播，该过程可能需要生成多个IRP_MJ_CREATE请求。

要求

要求	价值
最低支持的客户端	FsRtlAllocateExtraCreateParameter 例程从 Windows Vista 开始可用。
目标平台	普遍
标头	ntifs.h （include Ntifs.h）
库	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL