fonction CM_Add_IDA (cfgmgr32.h)

  • Article

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ériel ou à la liste d’ID compatibled’un appareil instance.

Syntaxe

CMAPI CONFIGRET CM_Add_IDA(
  DEVINST dnDevInst,
  PSTR    pszID,
  ULONG   ulFlags
);

Paramètres

dnDevInst

L’appareil fourni par l’appelant instance handle lié à l’ordinateur local.

pszID

Pointeur fourni par l’appelant vers une chaîne d’ID d’appareil terminée par NULL.

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 compatible de l’appareil spécifique instance.
CM_ADD_ID_HARDWARE L’ID d’appareil spécifié doit être ajouté à la liste d’ID matériel de l’appareil spécifique instance.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur CR_ préfixés 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é 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 d’appareil.

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

Condition requise Valeur
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

Voir aussi

CM_Add_ID_Ex
CM_Get_Child