Partager via


fonction CM_Add_Res_Des (cfgmgr32.h)

La fonction CM_Add_Res_Des ajoute un descripteur de ressource à une configuration logique .

Syntaxe

CMAPI CONFIGRET CM_Add_Res_Des(
  [out, optional] PRES_DES   prdResDes,
  [in]            LOG_CONF   lcLogConf,
  [in]            RESOURCEID ResourceID,
  [in]            PCVOID     ResourceData,
  [in]            ULONG      ResourceLen,
  [in]            ULONG      ulFlags
);

Paramètres

[out, optional] prdResDes

Pointeur vers un emplacement pour recevoir un handle vers le nouveau descripteur de ressource.

[in] lcLogConf

Handle fourni par l’appelant à la configuration logique à laquelle le descripteur de ressource doit être ajouté. Ce handle doit avoir été obtenu précédemment en appelant l’une des fonctions suivantes :

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[in] ResourceID

Identificateur de type de ressource fourni par l’appelant, qui identifie le type de structure fourni par ResourceData. Il doit s’agir de l’une des constantes ResType_-préfixe définies dans Cfgmgr32.h.

[in] ResourceData

Pointeur fourni par l’appelant vers l’une des structures de ressources répertoriées dans le tableau suivant.

paramètre ResourceID Structure des ressources
ResType_BusNumber

BUSNUMBER_RESOURCE

ResType_ClassSpecific

CS_RESOURCE

ResType_DevicePrivate

DEVPRIVATE_RESOURCE

ResType_DMA

DMA_RESOURCE

ResType_IO

IO_RESOURCE

ResType_IRQ

IRQ_RESOURCE

ResType_Mem

MEM_RESOURCE

ResType_MfCardConfig

MFCARD_RESOURCE

ResType_PcCardConfig

PCCARD_RESOURCE

[in] ResourceLen

Longueur fournie par l’appelant de la structure pointée par ResourceData.

[in] ulFlags

Non utilisé, doit être égal à zéro.

Valeur de retour

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.

Remarque à partir de Windows 8, CM_Add_Res_Des retourne CR_CALL_NOT_IMPLEMENTED lorsqu’elle est utilisée dans un scénario Wow64. Pour demander des informations sur les ressources matérielles sur un ordinateur local, il est nécessaire d’implémenter une version native de l’architecture de l’application à l’aide des API de ressources matérielles. Par exemple : application AMD64 pour les systèmes AMD64.
 

Remarques

Les appelants de CM_Add_Res_Des doivent appeler CM_Free_Res_Des_Handle pour libérer le descripteur de ressource, une fois qu’il n’est plus nécessaire.

Les appelants de cette fonction doivent avoir SeLoadDriverPrivilege. (Les privilèges sont décrits dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows.)

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
plateforme cible Bureau
d’en-tête cfgmgr32.h (include Cfgmgr32.h)
bibliothèque Cfgmgr32.lib
DLL Cfgmgr32.dll

Voir aussi

CM_Add_Res_Des_Ex

CM_Free_Res_Des_Handle