PcNewResourceSublist function

The PcNewResourceSublist function creates and initializes an empty resource list that is derived from another resource list.

Syntax


NTSTATUS PcNewResourceSublist(
  _Out_     PRESOURCELIST *OutResourceList,
  _In_opt_  PUNKNOWN OuterUnknown,
  _In_      POOL_TYPE PoolType,
  _In_      PRESOURCELIST ParentList,
  _In_      ULONG MaximumEntries
);

Parameters

OutResourceList [out]

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.

OuterUnknown [in, optional]

Pointer to the IUnknown interface of an object that needs to aggregate the 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.

ParentList [in]

Pointer to the resource list from which the child list will be created. The resource list has an IResourceList interface.

MaximumEntries [in]

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

Version

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)

Library

Portcls.lib

IRQL

PASSIVE_LEVEL

See also

IResourceList
POOL_TYPE
IResourceList::AddEntryFromParent

 

 

Send comments about this topic to Microsoft

Показ:
© 2014 Microsoft