PcNewResourceList 函数 (portcls.h)

PcNewResourceList 函数创建并初始化资源列表。

语法

PORTCLASSAPI NTSTATUS PcNewResourceList(
  [out]          PRESOURCELIST     *OutResourceList,
  [in, optional] PUNKNOWN          OuterUnknown,
  [in]           POOL_TYPE         PoolType,
  [in]           PCM_RESOURCE_LIST TranslatedResources,
  [in]           PCM_RESOURCE_LIST UntranslatedResources
);

参数

[out] OutResourceList

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

[in, optional] OuterUnknown

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

[in] PoolType

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

[in] TranslatedResources

指向已翻译资源的 WDM 提供的资源列表的指针。 列表是 CM_RESOURCE_LIST 类型的系统结构。

[in] UntranslatedResources

指向未翻译资源的 WDM 提供的资源列表的指针。 列表是 CM_RESOURCE_LIST 类型的系统结构。

返回值

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

注解

有关已翻译和未翻译 (或“原始”) 资源列表的讨论，请参阅 将 Bus-Relative 地址映射到虚拟地址。

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

要求

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

另请参阅

CM_RESOURCE_LIST

IResourceList

POOL_TYPE