función CM_Add_IDA (cfgmgr32.h)

La función CM_Add_ID anexa un identificador de dispositivo especificado (si aún no está presente) a la lista de identificadores de hardware de una instancia de dispositivo o a la lista de identificadores compatibles.

Sintaxis

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

Parámetros

dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.

pszID

Puntero proporcionado por el autor de la llamada a una cadena de identificador de dispositivo terminada en NULL.

ulFlags

Constante de marca proporcionada por el autor de la llamada que especifica la lista en la que se debe anexar el identificador de dispositivo proporcionado. Las siguientes constantes de marca son válidas.

Flag (constante) Definición
CM_ADD_ID_COMPATIBLE El identificador de dispositivo especificado debe anexarse a la lista de identificadores compatibles de la instancia de dispositivo específica.
CM_ADD_ID_HARDWARE El identificador de dispositivo especificado debe anexarse a la lista de identificadores de hardware de la instancia de dispositivo específica.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

La función CM_Add_ID solo se puede usar cuando dnDevInst representa un dispositivo enumerado por raíz. En el caso de otros dispositivos, el controlador de bus notifica los identificadores de hardware y compatibles al enumerar un dispositivo secundario después de recibir IRP_MN_QUERY_ID.

Cada identificador de dispositivo anexado se considera menos compatible que los identificadores que ya existen en la lista especificada. Para obtener información sobre los identificadores de dispositivo, los identificadores de hardware y los identificadores compatibles, consulte Cadenas de identificación de dispositivos.

Los autores de llamadas de esta función deben tener SeLoadDriverPrivilege. (Los privilegios se describen en la documentación de Microsoft Windows SDK).

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados al equipo local, consulte CM_Get_Child.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib

Consulte también

CM_Add_ID_Ex
CM_Get_Child