Поделиться через


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

Функция CM_Get_Resource_Conflict_Details получает сведения об одном из конфликтов ресурсов в списке конфликтов.

Синтаксис

CMAPI CONFIGRET CM_Get_Resource_Conflict_DetailsW(
  [in]      CONFLICT_LIST       clConflictList,
  [in]      ULONG               ulIndex,
  [in, out] PCONFLICT_DETAILS_W pConflictDetails
);

Параметры

[in] clConflictList

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

[in] ulIndex

Указанное вызывающей стороны значение, используемое в качестве индекса в списке конфликтов. Это значение может быть от нуля до единицы меньше числа, возвращаемого CM_Get_Resource_Conflict_Count.

[in, out] pConflictDetails

Указанный вызывающим адрес структуры CONFLICT_DETAILS для получения сведений о конфликте. Вызывающий объект должен предоставлять значения для структур CD_ulSize и CD_ulMask структуры.

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

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

Комментарии

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

  1. Вызовите CM_Query_Resource_Conflict_List, чтобы получить дескриптор списка конфликтов ресурсов.
  2. Вызовите CM_Get_Resource_Conflict_Count , чтобы определить количество конфликтов, содержащихся в списке конфликтов ресурсов.
  3. Вызовите CM_Get_Resource_Conflict_Details для каждой записи в списке конфликтов.
О следующих конфликтах обычно не сообщается:
  • Если для ресурса существует несколько конфликтов и можно определить владельцев только некоторых конфликтов, конфликты без идентифицируемых владельцев не сообщаются.
  • Конфликты, которые, как представляется, связаны с указанным устройством (то есть устройство конфликтует с самим собой), не сообщаются.
  • Если несколько устройств, отличных от Plug and Play, используют один и тот же драйвер, конфликты ресурсов между этими устройствами могут не сообщаться.
Иногда ресурсы, назначенные HAL, могут быть признаны конфликтующими с HAL или недоступными.

Требования

   
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть cfgmgr32.h (включая Cfgmgr32.h)
Библиотека Cfgmgr32.lib