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_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
如果在 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) |