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

Vedi anche

CM_RESOURCE_LIST

IResourceList

POOL_TYPE