PcNewResourceList function

The PcNewResourceList function creates and initializes a resource list.

Syntax


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

Parameters

OutResourceList [out]

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 [in, optional]

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 [in]

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

TranslatedResources [in]

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

UntranslatedResources [in]

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

Target platform

Universal

Version

The PortCls system driver implements the PcNewResourceList function in Microsoft Windows 98/Me and in Windows 2000 and later operating systems.

Header

Portcls.h (include Portcls.h)

Library

Portcls.lib

IRQL

PASSIVE_LEVEL

See also

IResourceList
POOL_TYPE
CM_RESOURCE_LIST

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft