функция CM_Add_IDA (cfgmgr32.h)
Функция CM_Add_ID добавляет указанный идентификатор устройства (если он еще отсутствует) в список идентификаторов оборудованияэкземпляра устройства или совместимый список идентификаторов.
Синтаксис
CMAPI CONFIGRET CM_Add_IDA(
DEVINST dnDevInst,
PSTR pszID,
ULONG ulFlags
);
Параметры
dnDevInst
Дескриптор экземпляра устройства, предоставленный вызывающим абонентом, привязанный к локальному компьютеру.
pszID
Предоставленный вызывающим элементом указатель на строку идентификатора устройства, завершаемую null.
ulFlags
Константу флага, предоставляемую вызывающим абонентом, которая указывает список, в который должен быть добавлен предоставленный идентификатор устройства. Допустимы следующие константы флага.
| Пометка константы | Определение |
|---|---|
| CM_ADD_ID_COMPATIBLE | Указанный идентификатор устройства должен быть добавлен в список совместимых идентификаторов конкретного экземпляра устройства. |
| CM_ADD_ID_HARDWARE | Указанный идентификатор устройства должен быть добавлен в список идентификаторов оборудования конкретного экземпляра устройства. |
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.
Комментарии
Функция CM_Add_ID может использоваться только в том случае, если dnDevInst представляет устройство с корневым перечислением. Для других устройств драйвер шины сообщает аппаратные и совместимые идентификаторы при перечислении дочернего устройства после получения IRP_MN_QUERY_ID.
Каждый добавленный идентификатор устройства считается менее совместимым, чем идентификаторы, уже существующие в указанном списке. Сведения об идентификаторах устройств, аппаратных идентификаторах и совместимых идентификаторах см. в разделе Строки идентификации устройств.
Вызывающие функции должны иметь SeLoadDriverPrivilege. (Привилегии описаны в документации по Microsoft Windows SDK.)
Сведения об использовании дескрипторов экземпляров устройства, привязанных к локальному компьютеру, см. в разделе CM_Get_Child.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib |