функция CM_Add_IDW (cfgmgr32.h)

Функция CM_Add_ID добавляет указанный идентификатор устройства (если он еще не присутствует) в список аппаратных идентификаторовэкземпляра устройства или список совместимых идентификаторов.

Синтаксис

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

Параметры

[in] dnDevInst

Вызывающий дескриптор экземпляра устройства, привязанный к локальному компьютеру.

[in] pszID

Вызывающий указатель на строку идентификатора устройства, завершаемого значением NULL.

[in] ulFlags

Константой флага, предоставленной вызывающей компанией, указывающей список, в который следует добавить предоставленный идентификатор устройства. Допустимы следующие константы флагов.

Возвращаемое значение

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с префиксом CR_, определенных в Cfgmgr32.h.

Замечания

Функцию CM_Add_ID можно использовать только в том случае, если dnDevInst представляет корневую перечислимую функцию. Для других устройств драйвер шины сообщает аппаратные и совместимые идентификаторы при перечислении дочернего устройства после получения IRP_MN_QUERY_ID.

Каждый добавленный идентификатор устройства считается менее совместимым, чем идентификаторы, уже существующие в указанном списке. Сведения об идентификаторах устройств, аппаратных идентификаторах и совместимых идентификаторах см. в разделе "Строки идентификации устройств".

Вызывающие функции должны иметь SeLoadDriverPrivilege. (Привилегии описаны в документации по пакету SDK для Microsoft Windows.)

Сведения об использовании дескрипторов экземпляра устройства, привязанных к локальному компьютеру, см. в CM_Get_Child.

Требования

См. также

CM_Add_ID_Ex

CM_Get_Child