função CM_Add_IDA (cfgmgr32.h)

A função CM_Add_ID acrescenta uma ID do 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_IDA(
  DEVINST dnDevInst,
  PSTR    pszID,
  ULONG   ulFlags
);

Parâmetros

dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao computador local.

pszID

Ponteiro fornecido pelo chamador para uma cadeia de caracteres de ID do dispositivo terminada em NULL.

ulFlags

Constante de sinalizador fornecida pelo chamador que especifica a lista na qual a ID do dispositivo fornecida deve ser acrescentada. As seguintes constantes de sinalizador são válidas.

Constante 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 do dispositivo específica.

Retornar valor

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

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

Confira também

CM_Add_ID_Ex
CM_Get_Child