Función PcNewResourceList (portcls.h)
La función pcNewResourceList de crea e inicializa una lista de recursos.
Sintaxis
PORTCLASSAPI NTSTATUS PcNewResourceList(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PCM_RESOURCE_LIST TranslatedResources,
[in] PCM_RESOURCE_LIST UntranslatedResources
);
Parámetros
[out] OutResourceList
Puntero de salida para el objeto resource-list creado por esta función. Este parámetro apunta a una 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 de IUnknown de un objeto que necesita agregar el objeto resource-list. 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] TranslatedResources
Puntero a una lista de recursos proporcionada por WDM para los recursos traducidos. La lista es una estructura del sistema de tipo CM_RESOURCE_LIST.
[in] UntranslatedResources
Puntero a una lista de recursos proporcionado por WDM para recursos sin traducir. La lista es una estructura del sistema de tipo CM_RESOURCE_LIST.
Valor devuelto
PcNewResourceList devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.
Observaciones
Para obtener una explicación de las listas de recursos traducidas y sin traducir (o "sin procesar"), consulte Asignación de direcciones Bus-Relative direcciones a direcciones virtuales.
Los parámetros OutResourceList y OuterUnknown 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 PcNewResourceList 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 |