структура CONFLICT_DETAILS_W (cfgmgr32.h)

Статья
11/20/2024

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

Синтаксис

typedef struct _CONFLICT_DETAILS_W {
  ULONG   CD_ulSize;
  ULONG   CD_ulMask;
  DEVINST CD_dnDevInst;
  RES_DES CD_rdResDes;
  ULONG   CD_ulFlags;
  WCHAR   CD_szDescription[MAX_PATH];
} CONFLICT_DETAILS_W, *PCONFLICT_DETAILS_W;

Члены

CD_ulSize

Размер в байтах структуры CONFLICT_DETAILS.

CD_ulMask

Один или несколько битовых флагов, предоставленных вызывающим CM_Get_Resource_Conflict_Details. Битовые флаги описаны в следующей таблице.

Флаг	Описание
CM_CDMASK_DEVINST	Если задано, CM_Get_Resource_Conflict_Details предоставляет значение для элемента CD_dnDevInst.
CM_CDMASK_RESDES	Не используется.
CM_CDMASK_FLAGS	Если задано, CM_Get_Resource_Conflict_Details предоставляет значение для элемента CD_ulFlags.
CM_CDMASK_DESCRIPTION	Если задано, CM_Get_Resource_Conflict_Details предоставляет значение для элемента CD_szDescription.

CD_dnDevInst

Если CM_CDMASK_DEVINST задано в CD_ulMask, этот элемент получит дескриптор экземпляру устройства с конфликтующими ресурсами. Если дескриптор недоступен, член получает -1.

CD_rdResDes

Не используется.

CD_ulFlags

Если CM_CDMASK_FLAGS задано в CD_ulMask, этот элемент может получать битовые флаги, перечисленные в следующей таблице.

Флаг	Описание
CM_CDFLAGS_DRIVER	Если задано, строка, содержащаяся в элементе CD_szDescription, представляет имя драйвера вместо имени устройства, а CD_dnDevInst — -1.
CM_CDFLAGS_ROOT_OWNED	Если задано, конфликтующие ресурсы принадлежат корневому устройству (то есть HAL), а CD_dnDevInst — -1.
CM_CDFLAGS_RESERVED	Если задано, владелец конфликтующих ресурсов не может быть определен и CD_dnDevInst равно -1.

CD_szDescription[MAX_PATH]

Если CM_CDMASK_DESCRIPTION задано в CD_ulMask, этот элемент получит текстовую строку, завершающую значение NULL, представляющую описание устройства, которому принадлежат ресурсы. Если CM_CDFLAGS_DRIVER задано в CD_ulFlags, эта строка представляет имя драйвера. Если задан CM_CDFLAGS_ROOT_OWNED или CM_CDFLAGS_RESERVED, строковое значение NULL.

Замечания

Заметка

Заголовок cfgmgr32.h определяет CONFLICT_DETAILS как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
заголовка	cfgmgr32.h (include Cfgmgr32.h)

См. также

CM_Get_Resource_Conflict_Details

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