Win32 API 日本語リファレンス
ホームDevices.DeviceAndDriverInstallation › CONFLICT_DETAILS_W

CONFLICT_DETAILS_W

構造体
サイズx64: 552 バイト / x86: 540 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
CD_ulSizeDWORD4+0+0CONFLICT_DETAILS 構造体のサイズ (バイト単位)。
CD_ulMaskCM_CDMASK4+4+4

CM_Get_Resource_Conflict_Details の呼び出し元が指定する 1 つ以上のビットフラグです。各ビットフラグは次の表のとおりです。

フラグ 説明
CM_CDMASK_DEVINST 設定されている場合、CM_Get_Resource_Conflict_DetailsCD_dnDevInst メンバーに値を設定します。
CM_CDMASK_RESDES 使用されません。
CM_CDMASK_FLAGS 設定されている場合、CM_Get_Resource_Conflict_DetailsCD_ulFlags メンバーに値を設定します。
CM_CDMASK_DESCRIPTION 設定されている場合、CM_Get_Resource_Conflict_DetailsCD_szDescription メンバーに値を設定します。
CD_dnDevInstDWORD4+8+8CD_ulMaskCM_CDMASK_DEVINST が設定されている場合、このメンバーはリソースが競合しているデバイスインスタンスのハンドルを受け取ります。ハンドルを取得できない場合、このメンバーは -1 を受け取ります。
CD_rdResDesUINT_PTR8/4+16+12使用されません。
CD_ulFlagsCM_CDFLAGS4+24+16

CD_ulMaskCM_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_szDescriptionWCHAR520+28+20CD_ulMaskCM_CDMASK_DESCRIPTION が設定されている場合、このメンバーはリソースを所有するデバイスの説明を表す NULL 終端のテキスト文字列を受け取ります。CD_ulFlagsCM_CDFLAGS_DRIVER が設定されている場合、この文字列はドライバー名を表します。CM_CDFLAGS_ROOT_OWNED または CM_CDFLAGS_RESERVED が設定されている場合、この文字列の値は NULL です。

公式ドキュメント

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

解説(Remarks)

メモ

cfgmgr32.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして CONFLICT_DETAILS を定義しています。エンコーディングに依存しないエイリアスと、エンコーディングに依存するコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、Conventions for Function Prototypes を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// CONFLICT_DETAILS_W  (x64 552 / x86 540 バイト)
typedef struct CONFLICT_DETAILS_W {
    DWORD CD_ulSize;
    CM_CDMASK CD_ulMask;
    DWORD CD_dnDevInst;
    UINT_PTR CD_rdResDes;
    CM_CDFLAGS CD_ulFlags;
    WCHAR CD_szDescription[260];
} CONFLICT_DETAILS_W;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CONFLICT_DETAILS_W
{
    public uint CD_ulSize;
    public uint CD_ulMask;
    public uint CD_dnDevInst;
    public UIntPtr CD_rdResDes;
    public uint CD_ulFlags;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string CD_szDescription;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CONFLICT_DETAILS_W
    Public CD_ulSize As UInteger
    Public CD_ulMask As UInteger
    Public CD_dnDevInst As UInteger
    Public CD_rdResDes As UIntPtr
    Public CD_ulFlags As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public CD_szDescription As String
End Structure
import ctypes
from ctypes import wintypes

class CONFLICT_DETAILS_W(ctypes.Structure):
    _fields_ = [
        ("CD_ulSize", wintypes.DWORD),
        ("CD_ulMask", wintypes.DWORD),
        ("CD_dnDevInst", wintypes.DWORD),
        ("CD_rdResDes", ctypes.c_size_t),
        ("CD_ulFlags", wintypes.DWORD),
        ("CD_szDescription", ctypes.c_wchar * 260),
    ]
#[repr(C)]
pub struct CONFLICT_DETAILS_W {
    pub CD_ulSize: u32,
    pub CD_ulMask: u32,
    pub CD_dnDevInst: u32,
    pub CD_rdResDes: usize,
    pub CD_ulFlags: u32,
    pub CD_szDescription: [u16; 260],
}
import "golang.org/x/sys/windows"

type CONFLICT_DETAILS_W struct {
	CD_ulSize uint32
	CD_ulMask uint32
	CD_dnDevInst uint32
	CD_rdResDes uintptr
	CD_ulFlags uint32
	CD_szDescription [260]uint16
}
type
  CONFLICT_DETAILS_W = record
    CD_ulSize: DWORD;
    CD_ulMask: DWORD;
    CD_dnDevInst: DWORD;
    CD_rdResDes: NativeUInt;
    CD_ulFlags: DWORD;
    CD_szDescription: array[0..259] of WideChar;
  end;
const CONFLICT_DETAILS_W = extern struct {
    CD_ulSize: u32,
    CD_ulMask: u32,
    CD_dnDevInst: u32,
    CD_rdResDes: usize,
    CD_ulFlags: u32,
    CD_szDescription: [260]u16,
};
type
  CONFLICT_DETAILS_W {.bycopy.} = object
    CD_ulSize: uint32
    CD_ulMask: uint32
    CD_dnDevInst: uint32
    CD_rdResDes: uint
    CD_ulFlags: uint32
    CD_szDescription: array[260, uint16]
struct CONFLICT_DETAILS_W
{
    uint CD_ulSize;
    uint CD_ulMask;
    uint CD_dnDevInst;
    size_t CD_rdResDes;
    uint CD_ulFlags;
    wchar[260] CD_szDescription;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CONFLICT_DETAILS_W サイズ: 540 バイト(x86)
dim st, 135    ; 4byte整数×135(構造体サイズ 540 / 4 切り上げ)
; CD_ulSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; CD_ulMask : CM_CDMASK (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; CD_dnDevInst : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; CD_rdResDes : UINT_PTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; CD_ulFlags : CM_CDFLAGS (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; CD_szDescription : WCHAR (+20, 520byte)  varptr(st)+20 を基点に操作(520byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CONFLICT_DETAILS_W サイズ: 552 バイト(x64)
dim st, 138    ; 4byte整数×138(構造体サイズ 552 / 4 切り上げ)
; CD_ulSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; CD_ulMask : CM_CDMASK (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; CD_dnDevInst : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; CD_rdResDes : UINT_PTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; CD_ulFlags : CM_CDFLAGS (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; CD_szDescription : WCHAR (+28, 520byte)  varptr(st)+28 を基点に操作(520byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CONFLICT_DETAILS_W
    #field int CD_ulSize
    #field int CD_ulMask
    #field int CD_dnDevInst
    #field intptr CD_rdResDes
    #field int CD_ulFlags
    #field wchar CD_szDescription 260
#endstruct

stdim st, CONFLICT_DETAILS_W        ; NSTRUCT 変数を確保
st->CD_ulSize = 100
mes "CD_ulSize=" + st->CD_ulSize