PcNewResourceSublist function (portcls.h)
The PcNewResourceSublist function creates and initializes an empty resource list that is derived from another resource list.
Syntax
PORTCLASSAPI NTSTATUS PcNewResourceSublist(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PRESOURCELIST ParentList,
[in] ULONG MaximumEntries
);
Parameters
[out] OutResourceList
Output pointer to the resource-list object that this function creates. This parameter points to the 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 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] ParentList
Pointer to the resource list from which the child list will be created. The resource list has an IResourceList interface.
[in] MaximumEntries
Specifies the maximum number of entries that will be added to the resource list.
Return value
PcNewResourceSublist returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.
Remarks
This function creates an empty resource sublist.
An adapter driver typically uses the PcNewResourceSublist function in combination with the IResourceList::AddEntryFromParent method to take the original list of resources that it received from the system and divide them up into sublists that it assigns to its various subdevices.
The OutResourceList, OuterUnknown, and ParentList parameters follow the reference-counting conventions for COM objects.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | The PortCls system driver implements the PcNewResourceSublist 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 |