PcNewResourceList function

The PcNewResourceList function creates and initializes a resource list.

Syntax

PORTCLASSAPI NTSTATUS PcNewResourceList(
  PRESOURCELIST     *OutResourceList,
  PUNKNOWN          OuterUnknown,
  POOL_TYPE         PoolType,
  PCM_RESOURCE_LIST TranslatedResources,
  PCM_RESOURCE_LIST UntranslatedResources
);

Parameters

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.

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.

PoolType

Specifies the type of pool from which the object is to be allocated. This is a POOL_TYPE enumeration value.

TranslatedResources

Pointer to a WDM-supplied resource list for translated resources. The list is a system structure of type CM_RESOURCE_LIST.

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

   
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

See also

CM_RESOURCE_LIST

IResourceList

POOL_TYPE