funzione CM_Add_IDW (cfgmgr32.h)

La funzione CM_Add_ID aggiunge un ID dispositivo specificato (se non è già presente) all'elenco di ID hardwaredi un'istanza del dispositivo o all'elencodi ID compatibili.

Sintassi

CMAPI CONFIGRET CM_Add_IDW(
  [in] DEVINST dnDevInst,
  [in] PWSTR   pszID,
  [in] ULONG   ulFlags
);

Parametri

[in] dnDevInst

Handle dell'istanza del dispositivo fornita dal chiamante associato al computer locale.

[in] pszID

Puntatore fornito dal chiamante a una stringa ID dispositivo con terminazione NULL.

[in] ulFlags

Costante flag fornita dal chiamante che specifica l'elenco in cui deve essere aggiunto l'ID dispositivo fornito. Le costanti flag seguenti sono valide.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Osservazioni:

La funzione CM_Add_ID può essere usata solo quando dnDevInst rappresenta un dispositivo enumerato radice. Per altri dispositivi, il driver del bus segnala id hardware e compatibili durante l'enumerazione di un dispositivo figlio dopo aver ricevuto IRP_MN_QUERY_ID.

Ogni ID dispositivo aggiunto viene considerato meno compatibile rispetto agli ID già esistenti nell'elenco specificato. Per informazioni su ID dispositivo, ID hardware e ID compatibili, vedere Stringhe di identificazione del dispositivo.

I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.

Per informazioni sull'uso di handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.

Requisiti

Vedere anche

CM_Add_ID_Ex

CM_Get_Child