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

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

Синтаксис

CMAPI CONFIGRET CM_Add_IDA(
  DEVINST dnDevInst,
  PSTR    pszID,
  ULONG   ulFlags
);

Параметры

dnDevInst

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

pszID

Предоставленный вызывающим элементом указатель на строку идентификатора устройства, завершаемую null.

ulFlags

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

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

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

Комментарии

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

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

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

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

Требования

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

CM_Add_ID_Ex
CM_Get_Child