IResourceList::AddEntryFromParent 方法 (portcls.h)

方法 AddEntryFromParent 向资源列表添加在资源列表的父列表中找到的条目。

语法

NTSTATUS AddEntryFromParent(
  [in] IResourceList    *Parent,
  [in] CM_RESOURCE_TYPE Type,
  [in] ULONG            Index
);

参数

[in] Parent

指向要从中获取条目的父 IResourceList 对象的指针。

[in] Type

标识要添加的条目的资源类型。 有关有效资源类型值的列表,请参阅 CM_PARTIAL_RESOURCE_DESCRIPTOR 结构的 Type 成员的说明。

[in] Index

指定要添加的项的父列表中的索引。 如果父级的 IResourceList::NumberOfEntriesOfType 方法返回类型类型条目数的值 n,则有效索引范围为 0 到 n-1。 例如,如果 Index 为零,则方法从父列表中添加指定类型的条目的第一个匹配项。

返回值

AddEntryFromParent 如果调用成功,则返回STATUS_SUCCESS。 否则,该方法将返回相应的错误代码。 下表显示了一些可能的返回状态代码。

返回代码 说明
STATUS_INSUFFICIENT_RESOURCES
指示列表中没有可用条目。
STATUS_INVALID_PARAMETER
指示在父列表中找不到该条目。

注解

对于每个资源类型,定义了一个宏来调用此方法。 请参阅 IResourceList

Parent 参数遵循 COM 对象的引用计数约定

要求

要求
目标平台 通用
标头 portcls.h (包括 Portcls.h)
IRQL PASSIVE_LEVEL

另请参阅

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::NumberOfEntriesOfType