Edit

Share via

CONFLICT_DETAILS_A structure (cfgmgr32.h)

  • Article

The CONFLICT_DETAILS structure is used as a parameter to the CM_Get_Resource_Conflict_Details function.

Syntax

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;

Members

CD_ulSize

Size, in bytes, of the CONFLICT_DETAILS structure.

CD_ulMask

One or more bit flags supplied by the caller of CM_Get_Resource_Conflict_Details. The bit flags are described in the following table.

Flag Description
CM_CDMASK_DEVINST If set, CM_Get_Resource_Conflict_Details supplies a value for the CD_dnDevInst member.
CM_CDMASK_RESDES Not used.
CM_CDMASK_FLAGS If set, CM_Get_Resource_Conflict_Details supplies a value for the CD_ulFlags member.
CM_CDMASK_DESCRIPTION If set, CM_Get_Resource_Conflict_Details supplies a value for the CD_szDescription member.

CD_dnDevInst

If CM_CDMASK_DEVINST is set in CD_ulMask, this member will receive a handle to a device instance that has conflicting resources. If a handle is not obtainable, the member receives -1.

CD_rdResDes

Not used.

CD_ulFlags

If CM_CDMASK_FLAGS is set in CD_ulMask, this member can receive bit flags listed in the following table.

Flag Description
CM_CDFLAGS_DRIVER If set, the string contained in the CD_szDescription member represents a driver name instead of a device name, and CD_dnDevInst is -1.
CM_CDFLAGS_ROOT_OWNED If set, the conflicting resources are owned by the root device (that is, the HAL), and CD_dnDevInst is -1.
CM_CDFLAGS_RESERVED If set, the owner of the conflicting resources cannot be determined, and CD_dnDevInst is -1.

CD_szDescription[MAX_PATH]

If CM_CDMASK_DESCRIPTION is set in CD_ulMask, this member will receive a NULL-terminated text string representing a description of the device that owns the resources. If CM_CDFLAGS_DRIVER is set in CD_ulFlags, this string represents a driver name. If CM_CDFLAGS_ROOT_OWNED or CM_CDFLAGS_RESERVED is set, the string value is NULL.

Remarks

Note

The cfgmgr32.h header defines CONFLICT_DETAILS as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Header cfgmgr32.h (include Cfgmgr32.h)

See also

CM_Get_Resource_Conflict_Details