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 asignada por el autor de la llamada en la que la función genera el puntero al objeto IResourceList. Especifique un valor de punteroNULL 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.
Observaciones
Esta función crea una sublist de recursos vacía.
Normalmente, un controlador de adaptador usa la función de 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 ,, OuterUnknowny ParentList siguen las convenciones de recuento de referencias para objetos COM.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | 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. |
| de la plataforma de destino de | Universal |
| encabezado de | portcls.h (incluya Portcls.h) |
| biblioteca de | Portcls.lib |
| irQL | PASSIVE_LEVEL |