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 puntatore non NULL valido per questo parametro.
[in, optional] OuterUnknown
Puntatore all'interfaccia IUnknown di un oggetto che deve aggregare l'oggetto resource-list. 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 tradotte. 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.
Commenti
Per una discussione sugli elenchi di risorse tradotti e non tradotti (o non elaborati), vedere Mapping di indirizzi Bus-Relative a indirizzi virtuali.
I parametri OutResourceList e OuterUnknown seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.
Requisiti
| 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 (includere Portcls.h) |
| Libreria | Portcls.lib |
| IRQL | PASSIVE_LEVEL |