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の呼び出し元によって提供される 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

CM_CDMASK_DEVINSTが CD_ulMask で設定されている場合、このメンバーは、リソースが競合しているデバイス インスタンスへのハンドルを受け取ります。 ハンドルが取得できない場合、メンバーは -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]

CM_CDMASK_DESCRIPTIONが CD_ulMask で設定されている場合、このメンバーは、リソースを所有するデバイスの説明を表す NULL で終わるテキスト文字列を受け取ります。 CD_ulFlags でCM_CDFLAGS_DRIVERが設定されている場合、この文字列はドライバー名を表します。 CM_CDFLAGS_ROOT_OWNEDまたはCM_CDFLAGS_RESERVEDが設定されている場合、文字列値は NULL です。

解説

注意

cfgmgr32.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてCONFLICT_DETAILSを定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

必要条件

   
Header cfgmgr32.h (Cfgmgr32.h を含む)

関連項目

CM_Get_Resource_Conflict_Details