Fonction PcNewResourceSublist (portcls.h)
La fonction PcNewResourceSublist crée et initialise une liste de ressources vide dérivée d’une autre liste de ressources.
Syntaxe
PORTCLASSAPI NTSTATUS PcNewResourceSublist(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PRESOURCELIST ParentList,
[in] ULONG MaximumEntries
);
Paramètres
[out] OutResourceList
Pointeur de sortie vers l’objet resource-list créé par cette fonction. Ce paramètre pointe vers la variable pointeur allouée par l’appelant dans laquelle la fonction génère le pointeur vers l’objet IResourceList . Spécifiez une valeur de pointeur non NULL valide pour ce paramètre.
[in, optional] OuterUnknown
Pointeur vers l’interface IUnknown d’un objet qui doit agréger l’objet. Sauf si l’agrégation est requise, définissez ce paramètre sur NULL.
[in] PoolType
Spécifie le type de pool à partir duquel l’objet doit être alloué. Il s’agit d’une valeur d’énumération POOL_TYPE .
[in] ParentList
Pointeur vers la liste de ressources à partir de laquelle la liste enfant sera créée. La liste de ressources a une interface IResourceList .
[in] MaximumEntries
Spécifie le nombre maximal d’entrées qui seront ajoutées à la liste de ressources.
Valeur retournée
PcNewResourceSublist retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié.
Remarques
Cette fonction crée une sous-liste de ressources vide.
Un pilote d’adaptateur utilise généralement la fonction PcNewResourceSublist en association avec la méthode IResourceList ::AddEntryFromParent pour prendre la liste d’origine des ressources qu’il a reçues du système et les diviser en sous-listes qu’il affecte à ses différents sous-appareils.
Les paramètres OutResourceList, OuterUnknown et ParentList suivent les conventions de comptage des références pour les objets COM.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Le pilote système PortCls implémente la fonction PcNewResourceSublist dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieur. |
| Plateforme cible | Universal |
| En-tête | portcls.h (include Portcls.h) |
| Bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |