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

Voir aussi

CM_RESOURCE_LIST

IResourceList

POOL_TYPE