PcNewResourceSublist 函数 (portcls.h)

PcNewResourceSublist 函数创建并初始化派生自另一个资源列表的空资源列表。

语法

PORTCLASSAPI NTSTATUS PcNewResourceSublist(
  [out]          PRESOURCELIST *OutResourceList,
  [in, optional] PUNKNOWN      OuterUnknown,
  [in]           POOL_TYPE     PoolType,
  [in]           PRESOURCELIST ParentList,
  [in]           ULONG         MaximumEntries
);

参数

[out] OutResourceList

指向此函数创建的资源列表对象的输出指针。 此参数指向调用方分配的指针变量，函数将指针输出到 IResourceList 对象。 为此参数指定有效的非 NULL 指针值。

[in, optional] OuterUnknown

指向需要聚合对象的对象的 IUnknown 接口的指针。 除非需要聚合，否则请将此参数设置为 NULL。

[in] PoolType

指定要从中分配对象的池的类型。 这是一个 POOL_TYPE 枚举值。

[in] ParentList

指向将从中创建子列表的资源列表的指针。 资源列表具有 IResourceList 接口。

[in] MaximumEntries

指定将添加到资源列表的最大条目数。

返回值

如果调用成功，PcNewResourceSublist 将返回STATUS_SUCCESS。 否则，它将返回相应的错误代码。

注解

此函数创建一个空资源子列表。

适配器驱动程序通常结合使用 PcNewResourceSublist 函数和 IResourceList：：AddEntryFromParent 方法，获取它从系统收到的原始资源列表，并将其划分为分配给其各个子对象的子列表。

OutResourceList、OuterUnknown 和 ParentList 参数遵循 COM 对象的引用计数约定。

要求

要求	值
最低受支持的客户端	PortCls 系统驱动程序在 Microsoft Windows 98/Me 和 Windows 2000 及更高版本的操作系统中实现 PcNewResourceSublist 函数。
目标平台	通用
标头	portcls.h (包括 Portcls.h)
Library	Portcls.lib
IRQL	PASSIVE_LEVEL

另请参阅

IResourceList

IResourceList：：AddEntryFromParent

POOL_TYPE