FsRtlFindExtraCreateParameter 函数（ntifs.h）

项目
12/21/2024

FsRtlFindExtraCreateParameter 例程搜索给定类型的 ECP 上下文结构，并返回指向此结构的指针（如果找到）。

语法

NTSTATUS FsRtlFindExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out, optional] PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

参数

[in] EcpList

指向 FsRtlFindExtraCreateParameter 用于搜索 EcpType 参数提供的 ECP 上下文结构的 ECP 列表结构的指针。

[in] EcpType

指向唯一标识 ECP 上下文结构的 GUID 的指针。 FsRtlFindExtraCreateParamter 例程使用此 GUID 值来确定 ECP 上下文结构是否存在于 ECP 列表中，EcpList 参数提供。

[out, optional] EcpContext

接收指向找到的 ECP 上下文结构的指针的可选参数。如果在 ECP 列表中找不到 ECP 上下文结构，EcpContext 设置为 NULL。如果调用方将 EcpContext 设置为 NULL，则可以使用 FsRtlFindExtraCreateParamter 的返回值来确定 ECP 上下文结构是否位于 ECP 列表中。

[out, optional] EcpContextSize

可选参数，用于接收找到的 ECP 上下文结构的大小（以字节为单位）。如果未找到 ECP 上下文结构，EcpContextSize 设置为零。

返回值

FsRtlFindExtraCreateParameter 返回以下 NTSTATUS 值之一：

返回代码	描述
STATUS_SUCCESS	FsRtlFindExtraCreateParameter 在指定的 ECP 列表中找到了指定的 ECP 上下文结构。
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter 未在指定的 ECP 列表中找到指定的 ECP 上下文结构。

要求

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