共用方式為


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)

另請參閱

CM_Get_Resource_Conflict_Details