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 |