CM_Add_IDW, fonction (cfgmgr32.h)
La fonction CM_Add_ID ajoute un ID d’appareil spécifié (s’il n’est pas déjà présent) à la liste d’ID matérielsd’un instance d’appareil ou à la liste d’ID compatibles.
Syntaxe
CMAPI CONFIGRET CM_Add_IDW(
[in] DEVINST dnDevInst,
[in] PWSTR pszID,
[in] ULONG ulFlags
);
Paramètres
[in] dnDevInst
Handle de instance d’appareil fourni par l’appelant qui est lié à l’ordinateur local.
[in] pszID
Pointeur fourni par l’appelant vers une chaîne d’ID d’appareil terminée par NULL.
[in] ulFlags
Constante d’indicateur fournie par l’appelant qui spécifie la liste à laquelle l’ID d’appareil fourni doit être ajouté. Les constantes d’indicateur suivantes sont valides.
| Constante d’indicateur | Définition |
|---|---|
| CM_ADD_ID_COMPATIBLE | L’ID d’appareil spécifié doit être ajouté à la liste d’ID compatibles de l’instance d’appareil spécifique. |
| CM_ADD_ID_HARDWARE | L’ID d’appareil spécifié doit être ajouté à la liste des ID matériels de l’instance d’appareil spécifique. |
Valeur retournée
Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.
Remarques
La fonction CM_Add_ID ne peut être utilisée que lorsque dnDevInst représente un appareil énuméré par la racine. Pour les autres appareils, le pilote de bus signale le matériel et les ID compatibles lors de l’énumération d’un appareil enfant après avoir reçu IRP_MN_QUERY_ID.
Chaque ID d’appareil ajouté est considéré comme moins compatible que les ID déjà existants dans la liste spécifiée. Pour plus d’informations sur les ID d’appareil, les ID matériels et les ID compatibles, consultez Chaînes d’identification des appareils.
Les appelants de cette fonction doivent avoir SeLoadDriverPrivilege. (Les privilèges sont décrits dans la documentation Microsoft Windows SDK.)
Pour plus d’informations sur l’utilisation de handles de instance d’appareil liés à l’ordinateur local, consultez CM_Get_Child.
Configuration requise
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib |