función CM_Add_IDW (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 una lista de identificadores compatibles.

Syntax

CMAPI CONFIGRET CM_Add_IDW(
  [in] DEVINST dnDevInst,
  [in] PWSTR   pszID,
  [in] ULONG   ulFlags
);

Parámetros

[in] dnDevInst

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

[in] pszID

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

[in] 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.

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 CR_ prefijo definidos en Cfgmgr32.h.

Observaciones

La función CM_Add_ID solo se puede usar cuando dnDevInst representa un dispositivo enumerado en raíz. Para otros dispositivos, el controlador de bus notifica hardware e identificadores 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 del SDK de Microsoft Windows).

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a la máquina local, consulte CM_Get_Child.

Requisitos

Consulte también

CM_Add_ID_Ex

CM_Get_Child