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 :
[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 | |
ResType_ClassSpecific | |
ResType_DevicePrivate | |
ResType_DMA | |
ResType_IO | |
ResType_IRQ | |
ResType_Mem | |
ResType_MfCardConfig | |
ResType_PcCardConfig |
[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.
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 |