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.

Costante Flag	Definizione
CM_ADD_ID_COMPATIBLE	L'ID dispositivo specificato deve essere aggiunto all'elenco di ID compatibili dell'istanza del dispositivo specifico.
CM_ADD_ID_HARDWARE	L'ID dispositivo specificato deve essere aggiunto all'elenco di ID hardware dell'istanza del dispositivo specifico.

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

Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib

Vedi anche

CM_Add_ID_Ex

CM_Get_Child