PcNewResourceSublist function (portcls.h)
The PcNewResourceSublist function creates and initializes an empty resource list that is derived from another resource list.
PORTCLASSAPI NTSTATUS PcNewResourceSublist( [out] PRESOURCELIST *OutResourceList, [in, optional] PUNKNOWN OuterUnknown, [in] POOL_TYPE PoolType, [in] PRESOURCELIST ParentList, [in] ULONG MaximumEntries );
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.
Specifies the type of pool from which the object is to be allocated. This is a POOL_TYPE enumeration value.
Pointer to the resource list from which the child list will be created. The resource list has an IResourceList interface.
Specifies the maximum number of entries that will be added to the resource list.
PcNewResourceSublist returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.
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.
|Minimum supported client||The PortCls system driver implements the PcNewResourceSublist function in Microsoft Windows 98/Me and in Windows 2000 and later operating systems.|
|Header||portcls.h (include Portcls.h)|
Submit and view feedback for