FsRtlFindExtraCreateParameter 函数 (ntifs.h)
FsRtlFindExtraCreateParameter 例程在给定 ECP 列表中搜索给定类型的 ECP 上下文结构,并返回指向此结构的指针(如果找到)。
语法
NTSTATUS FsRtlFindExtraCreateParameter(
[in] PECP_LIST EcpList,
[in] LPCGUID EcpType,
[out, optional] PVOID *EcpContext,
[out, optional] ULONG *EcpContextSize
);
参数
[in] EcpList
指向 FsRtlFindExtraCreateParameter 用于搜索 ECP 上下文结构的 ECP 列表结构的指针,该结构由 EcpType 参数提供。
[in] EcpType
指向唯一标识 ECP 上下文结构的 GUID 的指针。 FsRtlFindExtraCreateParamter 例程使用此 GUID 值来确定 ECP 上下文结构是否存在于 EcpList 参数提供的 ECP 列表中。
[out, optional] EcpContext
可选参数,用于接收指向找到的 ECP 上下文结构的指针。 如果在 ECP 列表中找不到 ECP 上下文结构, 则 EcpContext 设置为 NULL。 如果 EcpContext 被调用方设置为 NULL ,则 FsRtlFindExtraCreateParamter 的返回值可用于确定 ECP 上下文结构是否在 ECP 列表中。
[out, optional] EcpContextSize
可选参数,用于接收所找到的 ECP 上下文结构的大小(以字节为单位)。 如果未找到 ECP 上下文结构, 则 EcpContextSize 设置为零。
返回值
FsRtlFindExtraCreateParameter 返回以下 NTSTATUS 值之一:
返回代码 | 说明 |
---|---|
|
FsRtlFindExtraCreateParameter 在指定的 ECP 列表中找到了指定的 ECP 上下文结构。 |
|
FsRtlFindExtraCreateParameter 在指定的 ECP 列表中找不到指定的 ECP 上下文结构。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | FsRtlFindExtraCreateParameter 例程从 Windows Vista 开始可用。 |
目标平台 | 通用 |
标头 | ntifs.h (包括 Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
另请参阅
FltAllocateExtraCreateParameterFromLookasideList