Fonction PcNewResourceList (portcls.h)
La fonction PcNewResourceList crée et initialise une liste de ressources.
Syntaxe
PORTCLASSAPI NTSTATUS PcNewResourceList(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PCM_RESOURCE_LIST TranslatedResources,
[in] PCM_RESOURCE_LIST UntranslatedResources
);
Paramètres
[out] OutResourceList
Pointeur de sortie pour l’objet resource-list créé par cette fonction. Ce paramètre pointe vers une variable de 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 resource-list. 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] TranslatedResources
Pointeur vers une liste de ressources fournies par WDM pour les ressources traduites. La liste est une structure système de type CM_RESOURCE_LIST.
[in] UntranslatedResources
Pointeur vers une liste de ressources fournie par WDM pour les ressources non traduites. La liste est une structure système de type CM_RESOURCE_LIST.
Valeur retournée
PcNewResourceList retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié.
Remarques
Pour une présentation des listes de ressources traduites et non traduites (ou « brutes »), consultez Mappage d’adresses Bus-Relative à des adresses virtuelles.
Les paramètres OutResourceList et OuterUnknown 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 PcNewResourceList dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieurs. |
| Plateforme cible | Universal |
| En-tête | portcls.h (include Portcls.h) |
| Bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |