fonction CM_Add_Res_Des (cfgmgr32.h)

Article
03/05/2025

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

Partager via