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) |