função CM_Add_IDW (cfgmgr32.h)
A função CM_Add_ID acrescenta uma ID de dispositivo especificada (se ainda não estiver presente) à lista de IDs de hardware ou à lista de IDs compatíveisde uma instância do dispositivo.
Sintaxe
CMAPI CONFIGRET CM_Add_IDW(
[in] DEVINST dnDevInst,
[in] PWSTR pszID,
[in] ULONG ulFlags
);
Parâmetros
[in] dnDevInst
Identificador de instância de dispositivo fornecido pelo chamador associado ao computador local.
[in] pszID
Ponteiro fornecido pelo chamador para uma cadeia de caracteres de ID do dispositivo terminada em NULL.
[in] ulFlags
Constante de sinalizador fornecida pelo chamador que especifica a lista na qual a ID do dispositivo fornecida deve ser acrescentada. As constantes de sinalizador a seguir são válidas.
| Constante de sinalizador | Definição |
|---|---|
| CM_ADD_ID_COMPATIBLE | A ID do dispositivo especificada deve ser acrescentada à lista de IDs compatíveis da instância de dispositivo específica. |
| CM_ADD_ID_HARDWARE | A ID do dispositivo especificada deve ser acrescentada à lista de IDs de hardware da instância de dispositivo específica. |
Valor retornado
Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.
Comentários
A função CM_Add_ID só pode ser usada quando dnDevInst representa um dispositivo enumerado por raiz. Para outros dispositivos, o motorista do barramento relata hardware e IDs compatíveis ao enumerar um dispositivo filho após receber IRP_MN_QUERY_ID.
Cada ID de dispositivo acrescentada é considerada menos compatível do que as IDs já existentes na lista especificada. Para obter informações sobre IDs de dispositivo, IDs de hardware e IDs compatíveis, consulte Cadeias de caracteres de identificação do dispositivo.
Os chamadores dessa função devem ter SeLoadDriverPrivilege. (Os privilégios são descritos na documentação do SDK do Microsoft Windows.)
Para obter informações sobre como usar identificadores de instância de dispositivo associados ao computador local, consulte CM_Get_Child.
Requisitos
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | cfgmgr32.h (inclua Cfgmgr32.h) |
| Biblioteca | Cfgmgr32.lib |