функция 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

См. также раздел

CM_Add_ID_Ex

CM_Get_Child