функция 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
Вызывающая константа флага, указывающая список, в который должен быть добавлен предоставленный идентификатор устройства. Следующие константы флага являются допустимыми.
| Пометка константы | Определение |
|---|---|
| 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 |