Fonction PcNewResourceSublist (portcls.h)

Article
02/26/2024

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

IResourceList

IResourceList ::AddEntryFromParent

POOL_TYPE

Partager via