funzione CM_Add_IDA (cfgmgr32.h)

  • Articolo

La funzione CM_Add_ID aggiunge un ID dispositivo specificato (se non già presente) all'elenco ID hardwaredi un'istanza del dispositivo o all'elencoID compatibile.

Sintassi

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

Parametri

dnDevInst

Handle di istanza del dispositivo fornito dal chiamante associato al computer locale.

pszID

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

ulFlags

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

Contrassegna costante Definizione
CM_ADD_ID_COMPATIBLE L'ID dispositivo specificato deve essere aggiunto all'elenco ID compatibile dell'istanza del dispositivo specifico.
CM_ADD_ID_HARDWARE L'ID dispositivo specificato deve essere aggiunto all'elenco 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 id hardware e compatibili durante l'enumerazione di un dispositivo figlio dopo aver ricevuto IRP_MN_QUERY_ID.

Ogni ID dispositivo aggiunto è 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 degli handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.

Requisiti

Requisito Valore
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