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
指向此函数创建的 resource-list 对象的输出指针。 此参数指向调用方分配的指针变量，函数将指针输出到 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） |
| 库 | Portcls.lib |
| IRQL | PASSIVE_LEVEL |