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 |