funzione CM_Add_IDW (cfgmgr32.h)

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

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 del 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.

Commenti

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

Ogni ID dispositivo aggiunto viene considerato meno compatibile rispetto agli ID già esistenti nell'elenco specificato. Per informazioni sugli ID dispositivo, gli ID hardware e gli 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

Vedi anche

CM_Add_ID_Ex

CM_Get_Child