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 结构的 类型 成员的说明。

[in] Index

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

返回值

如果调用成功,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