Función PcNewResourceSublist (portcls.h)

La función PcNewResourceSublist crea e inicializa una lista de recursos vacía derivada de otra lista de recursos.

Sintaxis

PORTCLASSAPI NTSTATUS PcNewResourceSublist(
  [out]          PRESOURCELIST *OutResourceList,
  [in, optional] PUNKNOWN      OuterUnknown,
  [in]           POOL_TYPE     PoolType,
  [in]           PRESOURCELIST ParentList,
  [in]           ULONG         MaximumEntries
);

Parámetros

[out] OutResourceList

Puntero de salida al objeto resource-list que crea esta función. Este parámetro apunta a la variable de puntero asignado por el autor de la llamada en la que la función genera el puntero al objeto IResourceList . Especifique un valor de puntero válido que no sea NULL para este parámetro.

[in, optional] OuterUnknown

Puntero a la interfaz IUnknown de un objeto que necesita agregar el objeto. A menos que se requiera la agregación, establezca este parámetro en NULL.

[in] PoolType

Especifica el tipo de grupo desde el que se va a asignar el objeto. Se trata de un valor de enumeración POOL_TYPE .

[in] ParentList

Puntero a la lista de recursos desde la que se creará la lista secundaria. La lista de recursos tiene una interfaz IResourceList .

[in] MaximumEntries

Especifica el número máximo de entradas que se agregarán a la lista de recursos.

Valor devuelto

PcNewResourceSublist devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

Esta función crea una sublista de recursos vacía.

Normalmente, un controlador de adaptador usa la función PcNewResourceSublist en combinación con el método IResourceList::AddEntryFromParent para tomar la lista original de recursos que recibió del sistema y dividirlos en sublists que asigna a sus diversos subdispositivos.

Los parámetros OutResourceList, OuterUnknown y ParentList siguen las convenciones de recuento de referencias para objetos COM.

Requisitos

Requisito Value
Cliente mínimo compatible El controlador del sistema PortCls implementa la función PcNewResourceSublist en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores.
Plataforma de destino Universal
Encabezado portcls.h (incluir Portcls.h)
Library Portcls.lib
IRQL PASSIVE_LEVEL

Consulte también

IResourceList

IResourceList::AddEntryFromParent

POOL_TYPE