CONFLICT_DETAILS_A结构(cfgmgr32.h)

CONFLICT_DETAILS结构用作 CM_Get_Resource_Conflict_Details 函数的参数。

语法

typedef struct _CONFLICT_DETAILS_A {
  ULONG   CD_ulSize;
  ULONG   CD_ulMask;
  DEVINST CD_dnDevInst;
  RES_DES CD_rdResDes;
  ULONG   CD_ulFlags;
  CHAR    CD_szDescription[MAX_PATH];
} CONFLICT_DETAILS_A, *PCONFLICT_DETAILS_A;

成员

CD_ulSize

CONFLICT_DETAILS结构的大小(以字节为单位)。

CD_ulMask

CM_Get_Resource_Conflict_Details调用方提供的一个或多个位标志。 下表描述了位标志。

描述
CM_CDMASK_DEVINST 如果已设置,CM_Get_Resource_Conflict_DetailsCD_dnDevInst 成员提供值。
CM_CDMASK_RESDES 未使用。
CM_CDMASK_FLAGS 如果已设置,CM_Get_Resource_Conflict_DetailsCD_ulFlags 成员提供值。
CM_CDMASK_DESCRIPTION 如果已设置,CM_Get_Resource_Conflict_DetailsCD_szDescription 成员提供一个值。

CD_dnDevInst

如果在 CD_ulMask中设置了CM_CDMASK_DEVINST,则此成员将收到具有冲突资源的设备实例的句柄。 如果无法获取句柄,则成员会收到 -1。

CD_rdResDes

未使用。

CD_ulFlags

如果在 CD_ulMask中设置了CM_CDMASK_FLAGS,则此成员可以接收下表中列出的位标志。

描述
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]

如果在 CD_ulMask中设置了CM_CDMASK_DESCRIPTION,则此成员将收到一个以 NULL 结尾的文本字符串,表示拥有资源的设备的说明。 如果在 CD_ulFlags中设置了CM_CDFLAGS_DRIVER,则此字符串表示驱动程序名称。 如果设置了CM_CDFLAGS_ROOT_OWNED或CM_CDFLAGS_RESERVED,则字符串值 NULL

言论

注意

cfgmgr32.h 标头将CONFLICT_DETAILS定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
标头 cfgmgr32.h (包括 Cfgmgr32.h)

另请参阅

CM_Get_Resource_Conflict_Details