Funzione PcNewResourceSublist (portcls.h)

La funzione PcNewResourceSublist crea e inizializza un elenco di risorse vuoto derivato da un altro elenco di risorse.

Sintassi

PORTCLASSAPI NTSTATUS PcNewResourceSublist(
  [out]          PRESOURCELIST *OutResourceList,
  [in, optional] PUNKNOWN      OuterUnknown,
  [in]           POOL_TYPE     PoolType,
  [in]           PRESOURCELIST ParentList,
  [in]           ULONG         MaximumEntries
);

Parametri

[out] OutResourceList

Puntatore di output all'oggetto resource-list creato da questa funzione. Questo parametro punta alla variabile puntatore allocata dal chiamante in cui la funzione restituisce il puntatore all'oggetto IResourceList . Specificare un valore di puntatore non NULL valido per questo parametro.

[in, optional] OuterUnknown

Puntatore all'interfaccia IUnknown di un oggetto che deve aggregare l'oggetto. 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] ParentList

Puntatore all'elenco di risorse da cui verrà creato l'elenco figlio. L'elenco di risorse ha un'interfaccia IResourceList .

[in] MaximumEntries

Specifica il numero massimo di voci che verranno aggiunte all'elenco di risorse.

Valore restituito

PcNewResourceSublist restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Commenti

Questa funzione crea un sottolista di risorse vuoto.

Un driver di adattatore usa in genere la funzione PcNewResourceSublist in combinazione con il metodo IResourceList::AddEntryFromParent per accettare l'elenco originale di risorse ricevute dal sistema e dividerle in sottoliste assegnate ai vari sottodispositivi.

I parametri OutResourceList, OuterUnknown e ParentList seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.

Requisiti

Vedi anche

IResourceList

IResourceList::AddEntryFromParent

POOL_TYPE