PcNewResourceSublist function (portcls.h)

Article
10/21/2021

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