Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |