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 |