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