PcNewResourceList function (portcls.h)
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
| Requirement | Value |
|---|---|
| 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 |