IResourceList ::AddEntryFromParent, méthode (portcls.h)
La méthode AddEntryFromParent ajoute à une liste de ressources une entrée trouvée dans la liste parente de la liste de ressources.
Syntaxe
NTSTATUS AddEntryFromParent(
[in] IResourceList *Parent,
[in] CM_RESOURCE_TYPE Type,
[in] ULONG Index
);
Paramètres
[in] Parent
Pointeur vers le IResourceList objet à partir duquel l’entrée doit être effectuée.
[in] Type
Identifie le type de ressource de l’entrée à ajouter. Pour obtenir la liste des valeurs de type de ressource valides, consultez la description du membre type de la structure CM_PARTIAL_RESOURCE_DESCRIPTOR.
[in] Index
Spécifie l’index dans la liste parente de l’entrée à ajouter. Si la méthode IResourceList ::NumberOfEntriesOfType parent retourne une valeur n pour le nombre d’entrées de type Type, les index valides sont compris entre 0 et n-1. Si index est égal à zéro, par exemple, la méthode ajoute la première occurrence d’une entrée du type spécifié à partir de la liste parente.
Valeur de retour
AddEntryFromParent retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié. Le tableau suivant présente certains des codes d’état de retour possibles.
| Retourner le code | Description |
|---|---|
|
Indique qu’il n’y a pas d’entrées gratuites dans la liste. |
|
Indique que l’entrée n’a pas été trouvée dans la liste parente. |
Remarques
Pour chaque type de ressource, une macro est définie pour appeler cette méthode. Voir IResourceList.
Le paramètre Parent suit les conventions de comptage de référence pour les objets COM.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| IRQL | PASSIVE_LEVEL |