Condividi tramite


Metodo IResourceList::AddEntryFromParent (portcls.h)

Il AddEntryFromParent metodo aggiunge a un elenco di risorse una voce trovata nell'elenco padre dell'elenco di risorse.

Sintassi

NTSTATUS AddEntryFromParent(
  [in] IResourceList    *Parent,
  [in] CM_RESOURCE_TYPE Type,
  [in] ULONG            Index
);

Parametri

[in] Parent

Puntatore all'oggetto IResourceList padre da cui deve essere presa la voce.

[in] Type

Identifica il tipo di risorsa della voce da aggiungere. Per un elenco di valori di tipo di risorsa validi, vedere la descrizione del membro Type della struttura CM_PARTIAL_RESOURCE_DESCRIPTOR .

[in] Index

Specifica l'indice nell'elenco padre della voce da aggiungere. Se il metodo IResourceList::NumberOfEntriesOfType restituisce un valore n per il numero di voci di tipo Type, gli indici validi sono compresi tra 0 e n-1. Se Index è zero, ad esempio, il metodo aggiunge la prima occorrenza di una voce del tipo specificato dall'elenco padre.

Valore restituito

AddEntryFromParent restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato. La tabella seguente mostra alcuni dei possibili codici di stato restituiti.

Codice restituito Descrizione
STATUS_INSUFFICIENT_RESOURCES
Indica che non sono presenti voci gratuite nell'elenco.
STATUS_INVALID_PARAMETER
Indica che la voce non è stata trovata nell'elenco padre.

Commenti

Per ogni tipo di risorsa, viene definita una macro per chiamare questo metodo. Vedere IResourceList.

Il parametro Parent segue le convenzioni di conteggio dei riferimenti per gli oggetti COM.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione portcls.h (includere Portcls.h)
IRQL PASSIVE_LEVEL

Vedi anche

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::NumberOfEntriesOfType