Funzione PcNewResourceList (portcls.h)
La funzione PcNewResourceList crea e inizializza un elenco di risorse.
Sintassi
PORTCLASSAPI NTSTATUS PcNewResourceList(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PCM_RESOURCE_LIST TranslatedResources,
[in] PCM_RESOURCE_LIST UntranslatedResources
);
Parametri
[out] OutResourceList
Puntatore di output per l'oggetto resource-list creato da questa funzione. Questo parametro punta a una variabile puntatore allocata dal chiamante in cui la funzione restituisce il puntatore all'oggetto IResourceList. Specificare un valore valido, nonNULL valore del puntatore per questo parametro.
[in, optional] OuterUnknown
Puntatore all'interfaccia IUnknown di un oggetto che deve aggregare l'oggetto elenco risorse. A meno che non sia necessaria l'aggregazione, impostare questo parametro su NULL.
[in] PoolType
Specifica il tipo di pool da cui deve essere allocato l'oggetto. Si tratta di un valore di enumerazione POOL_TYPE.
[in] TranslatedResources
Puntatore a un elenco di risorse fornito da WDM per le risorse tradotte. L'elenco è una struttura di sistema di tipo CM_RESOURCE_LIST.
[in] UntranslatedResources
Puntatore a un elenco di risorse fornito da WDM per le risorse non convertite. L'elenco è una struttura di sistema di tipo CM_RESOURCE_LIST.
Valore restituito
PcNewResourceList restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.
Osservazioni
Per una descrizione degli elenchi di risorse tradotti e non tradotti (o "non elaborati"), vedere Mapping degli indirizzi Bus-Relative agli indirizzi virtuali.
I parametri OutResourceList e OuterUnknown seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Il driver di sistema PortCls implementa la funzione PcNewResourceList in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive. |
| piattaforma di destinazione | Universale |
| intestazione | portcls.h (include Portcls.h) |
| libreria | Portcls.lib |
| IRQL | PASSIVE_LEVEL |