PcNewResourceList function (portcls.h)

Article
10/21/2021

The PcNewResourceList function creates and initializes a resource list.

Syntax

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

Parameters

[out] OutResourceList

Output pointer for the resource-list object created by this function. This parameter points to a caller-allocated pointer variable into which the function outputs the pointer to the IResourceList object. Specify a valid, non-NULL pointer value for this parameter.

[in, optional] OuterUnknown

Pointer to the IUnknown interface of an object that needs to aggregate the resource-list object. Unless aggregation is required, set this parameter to NULL.

[in] PoolType

Specifies the type of pool from which the object is to be allocated. This is a POOL_TYPE enumeration value.

[in] TranslatedResources

Pointer to a WDM-supplied resource list for translated resources. The list is a system structure of type CM_RESOURCE_LIST.

[in] UntranslatedResources

Pointer to a WDM-supplied resource list for untranslated resources. The list is a system structure of type CM_RESOURCE_LIST.

Return value

PcNewResourceList returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.

Remarks

For a discussion of translated and untranslated (or "raw") resource lists, see Mapping Bus-Relative Addresses to Virtual Addresses.

The OutResourceList and OuterUnknown parameters follow the reference-counting conventions for COM objects.

Requirements


Minimum supported client	The PortCls system driver implements the PcNewResourceList function in Microsoft Windows 98/Me and in Windows 2000 and later operating systems.
Target Platform	Universal
Header	portcls.h (include Portcls.h)
Library	Portcls.lib
IRQL	PASSIVE_LEVEL