CONFLICT_DETAILS_W構造体 (cfgmgr32.h)

  • [アーティクル]

CONFLICT_DETAILS構造体は、 CM_Get_Resource_Conflict_Details 関数のパラメーターとして使用されます。

構文

typedef struct _CONFLICT_DETAILS_W {
  ULONG   CD_ulSize;
  ULONG   CD_ulMask;
  DEVINST CD_dnDevInst;
  RES_DES CD_rdResDes;
  ULONG   CD_ulFlags;
  WCHAR   CD_szDescription[MAX_PATH];
} CONFLICT_DETAILS_W, *PCONFLICT_DETAILS_W;

メンバー

CD_ulSize

CONFLICT_DETAILS構造体のサイズ (バイト単位)。

CD_ulMask

CM_Get_Resource_Conflict_Detailsの呼び出し元によって提供される 1 つ以上のビット フラグ。 ビット フラグについては、次の表で説明します。

フラグ 説明
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 ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてCONFLICT_DETAILSを定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
Header cfgmgr32.h (Cfgmgr32.h を含む)

こちらもご覧ください

CM_Get_Resource_Conflict_Details