функция CM_Query_Resource_Conflict_List (cfgmgr32.h)
Функция CM_Query_Resource_Conflict_List определяет экземпляры устройств с требованиями к ресурсам, которые конфликтуют с описанием ресурса указанного экземпляра устройства.
Синтаксис
CMAPI CONFIGRET CM_Query_Resource_Conflict_List(
[out] PCONFLICT_LIST pclConflictList,
[in] DEVINST dnDevInst,
[in] RESOURCEID ResourceID,
[in] PCVOID ResourceData,
[in] ULONG ResourceLen,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Параметры
[out] pclConflictList
Указанный вызывающим абонентом адрес расположения для получения дескриптора списка конфликтов.
[in] dnDevInst
Дескриптор экземпляра устройства, предоставленный вызывающим абонентом, привязанный к дескрипторе компьютера, предоставленному hMachine.
[in] ResourceID
Идентификатор типа ресурса, предоставленный вызывающим абонентом. Это должна быть одна из ResType_ констант с префиксом, определенных в Cfgmgr32.h.
[in] ResourceData
Предоставленный вызывающим элементом указатель на дескриптор ресурса, который может быть одной из структур, перечисленных в описании ResourceData функции CM_Add_Res_Des.
[in] ResourceLen
Указанная вызывающим абонентом длина структуры, на которую указывает ResourceData.
[in] ulFlags
Не используется, должно быть равно нулю.
[in, optional] hMachine
Дескриптор компьютера, предоставленный вызывающим абонентом, к которому привязан дескриптор экземпляра устройства, предоставленный вызывающим абонентом.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с префиксом CR_, определенных в Cfgmgr32.h.
Комментарии
При вызове CM_Query_Resource_Conflict_List укажите дескриптор экземпляра устройства и дескриптор ресурса. (Дескрипторы ресурсов для существующих узлов устройств можно получить, вызвав CM_Get_Res_Des_Data.) Эти параметры указывают конкретные ресурсы, которые вы хотите использовать для конкретного устройства. Результирующий список конфликтов определяет устройства, использующие одни и те же ресурсы, а также ресурсы, зарезервированные компьютером.
После вызова CM_Query_Resource_Conflict_List приложение может вызвать CM_Get_Resource_Conflict_Count , чтобы определить количество конфликтов, содержащихся в списке конфликтов ресурсов. (Количество конфликтов может быть равно нулю.) Затем приложение может вызывать CM_Get_Resource_Conflict_Details для каждой записи в списке конфликтов.
После завершения работы приложения с дескриптором, полученным для pclConflictList, оно должно вызвать CM_Free_Resource_Conflict_Handle.
Сведения об использовании дескрипторов экземпляров устройства, привязанных к локальному или удаленному компьютеру, см. в разделе CM_Get_Child_Ex.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |
См. также раздел
CM_Free_Resource_Conflict_Handle