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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour