DISPLAYCONFIG_TARGET_DEVICE_NAME
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| header | DISPLAYCONFIG_DEVICE_INFO_HEADER | 20 | +0 | +0 | ターゲットデバイス名の要求に関する情報を格納する DISPLAYCONFIG_DEVICE_INFO_HEADER 構造体です。呼び出し元は、DISPLAYCONFIG_DEVICE_INFO_HEADER の type メンバーに DISPLAYCONFIG_DEVICE_INFO_GET_TARGET_NAME を設定し、DISPLAYCONFIG_DEVICE_INFO_HEADER の adapterId メンバーと id メンバーに、ターゲットデバイス名を取得したいターゲットを設定します。また、DISPLAYCONFIG_DEVICE_INFO_HEADER の size メンバーには、少なくとも DISPLAYCONFIG_TARGET_DEVICE_NAME 構造体のサイズを設定します。 |
| flags | DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS | 8/4 | +24 | +20 | ターゲットに関する情報をビットフィールドのフラグで示す DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS 構造体です。 |
| outputTechnology | DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY | 4 | +32 | +24 | ターゲットのコネクターの種類を指定する DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY 列挙型の値です。 |
| edidManufactureId | WORD | 2 | +36 | +28 | モニターの拡張ディスプレイ識別データ (EDID) から取得した製造元識別子です。このメンバーは、flags メンバー内の edidIdsValid ビットフィールドが設定されている場合にのみ設定されます。 |
| edidProductCodeId | WORD | 2 | +38 | +30 | モニターの EDID から取得した製品コードです。このメンバーは、flags メンバー内の edidIdsValid ビットフィールドが設定されている場合にのみ設定されます。 |
| connectorInstance | DWORD | 4 | +40 | +32 | アダプターがこの種類のターゲットを複数持つ場合にのみ意味を持つ、この特定のターゲットの 1 から始まるインスタンス番号です。コネクターインスタンスは、各アダプター内で一意な、1 から始まる連続した番号です。アダプター上にこの種類のターゲットが 1 つしかない場合、この値は 0 になります。 |
| monitorFriendlyDeviceName | WCHAR | 128 | +44 | +36 | モニターのデバイス名を表す NULL 終端の WCHAR 文字列です。この名前は SetupAPI.dll と共に使用して、インストールパッケージに含まれるデバイス名を取得できます。 |
| monitorDevicePath | WCHAR | 256 | +172 | +164 | モニターのデバイス名へのパスを表す NULL 終端の WCHAR 文字列です。このパスは SetupAPI.dll と共に使用して、インストールパッケージに含まれるデバイス名を取得できます。 |
公式ドキュメント
DISPLAYCONFIG_TARGET_DEVICE_NAME 構造体は、ターゲットに関する情報を格納します。
解説(Remarks)
拡張ディスプレイ識別データ (EDID) は、ディスプレイが自身の機能をグラフィックスアダプターに伝えるために提供する一連のデータです。EDID データにより、コンピューターは接続されているモニターの種類を検出できます。EDID データには、製造元名、製品の種類、ディスプレイがサポートするタイミング、ディスプレイのサイズのほか、その他のディスプレイ特性が含まれます。EDID は、Video Electronics Standards Association (VESA) が公開する標準規格によって定義されています。
名前付きデバイスオブジェクトは、\Device\DeviceName という形式のパスと名前を持ちます。これはデバイスオブジェクトのデバイス名と呼ばれます。
アプリケーションがモニター名を取得するために DisplayConfigGetDeviceInfo 関数を呼び出した際に、DisplayConfigGetDeviceInfo がモニター名を取得できなかった場合、またはモニターが接続されていない状態でターゲットが強制的に有効化されている場合、DISPLAYCONFIG_TARGET_DEVICE_NAME 構造体の monitorFriendlyDeviceName メンバーの文字列は NULL 文字列となり、DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS 構造体のビットフィールドフラグはいずれも設定されません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// LUID (x64 8 / x86 8 バイト)
typedef struct LUID {
DWORD LowPart;
INT HighPart;
} LUID;
// DISPLAYCONFIG_DEVICE_INFO_HEADER (x64 20 / x86 20 バイト)
typedef struct DISPLAYCONFIG_DEVICE_INFO_HEADER {
DISPLAYCONFIG_DEVICE_INFO_TYPE type;
DWORD size;
LUID adapterId;
DWORD id;
} DISPLAYCONFIG_DEVICE_INFO_HEADER;
// DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS (x64 8 / x86 4 バイト)
typedef struct DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS {
_Anonymous_e__Union Anonymous;
} DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS;
// DISPLAYCONFIG_TARGET_DEVICE_NAME (x64 432 / x86 420 バイト)
typedef struct DISPLAYCONFIG_TARGET_DEVICE_NAME {
DISPLAYCONFIG_DEVICE_INFO_HEADER header;
DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS flags;
DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY outputTechnology;
WORD edidManufactureId;
WORD edidProductCodeId;
DWORD connectorInstance;
WCHAR monitorFriendlyDeviceName[64];
WCHAR monitorDevicePath[128];
} DISPLAYCONFIG_TARGET_DEVICE_NAME;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LUID
{
public uint LowPart;
public int HighPart;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DISPLAYCONFIG_DEVICE_INFO_HEADER
{
public int type;
public uint size;
public LUID adapterId;
public uint id;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS
{
public _Anonymous_e__Union Anonymous;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DISPLAYCONFIG_TARGET_DEVICE_NAME
{
public DISPLAYCONFIG_DEVICE_INFO_HEADER header;
public DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS flags;
public int outputTechnology;
public ushort edidManufactureId;
public ushort edidProductCodeId;
public uint connectorInstance;
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)] public string monitorFriendlyDeviceName;
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)] public string monitorDevicePath;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LUID
Public LowPart As UInteger
Public HighPart As Integer
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DISPLAYCONFIG_DEVICE_INFO_HEADER
Public type As Integer
Public size As UInteger
Public adapterId As LUID
Public id As UInteger
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS
Public Anonymous As _Anonymous_e__Union
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DISPLAYCONFIG_TARGET_DEVICE_NAME
Public header As DISPLAYCONFIG_DEVICE_INFO_HEADER
Public flags As DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS
Public outputTechnology As Integer
Public edidManufactureId As UShort
Public edidProductCodeId As UShort
Public connectorInstance As UInteger
<MarshalAs(UnmanagedType.ByValTStr, SizeConst:=64)> Public monitorFriendlyDeviceName As String
<MarshalAs(UnmanagedType.ByValTStr, SizeConst:=128)> Public monitorDevicePath As String
End Structureimport ctypes
from ctypes import wintypes
class LUID(ctypes.Structure):
_fields_ = [
("LowPart", wintypes.DWORD),
("HighPart", ctypes.c_int),
]
class DISPLAYCONFIG_DEVICE_INFO_HEADER(ctypes.Structure):
_fields_ = [
("type", ctypes.c_int),
("size", wintypes.DWORD),
("adapterId", LUID),
("id", wintypes.DWORD),
]
class DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS(ctypes.Structure):
_fields_ = [
("Anonymous", _Anonymous_e__Union),
]
class DISPLAYCONFIG_TARGET_DEVICE_NAME(ctypes.Structure):
_fields_ = [
("header", DISPLAYCONFIG_DEVICE_INFO_HEADER),
("flags", DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS),
("outputTechnology", ctypes.c_int),
("edidManufactureId", ctypes.c_ushort),
("edidProductCodeId", ctypes.c_ushort),
("connectorInstance", wintypes.DWORD),
("monitorFriendlyDeviceName", ctypes.c_wchar * 64),
("monitorDevicePath", ctypes.c_wchar * 128),
]#[repr(C)]
pub struct LUID {
pub LowPart: u32,
pub HighPart: i32,
}
#[repr(C)]
pub struct DISPLAYCONFIG_DEVICE_INFO_HEADER {
pub type: i32,
pub size: u32,
pub adapterId: LUID,
pub id: u32,
}
#[repr(C)]
pub struct DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS {
pub Anonymous: _Anonymous_e__Union,
}
#[repr(C)]
pub struct DISPLAYCONFIG_TARGET_DEVICE_NAME {
pub header: DISPLAYCONFIG_DEVICE_INFO_HEADER,
pub flags: DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS,
pub outputTechnology: i32,
pub edidManufactureId: u16,
pub edidProductCodeId: u16,
pub connectorInstance: u32,
pub monitorFriendlyDeviceName: [u16; 64],
pub monitorDevicePath: [u16; 128],
}import "golang.org/x/sys/windows"
type LUID struct {
LowPart uint32
HighPart int32
}
type DISPLAYCONFIG_DEVICE_INFO_HEADER struct {
type int32
size uint32
adapterId LUID
id uint32
}
type DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS struct {
Anonymous _Anonymous_e__Union
}
type DISPLAYCONFIG_TARGET_DEVICE_NAME struct {
header DISPLAYCONFIG_DEVICE_INFO_HEADER
flags DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS
outputTechnology int32
edidManufactureId uint16
edidProductCodeId uint16
connectorInstance uint32
monitorFriendlyDeviceName [64]uint16
monitorDevicePath [128]uint16
}type
LUID = record
LowPart: DWORD;
HighPart: Integer;
end;
DISPLAYCONFIG_DEVICE_INFO_HEADER = record
type: Integer;
size: DWORD;
adapterId: LUID;
id: DWORD;
end;
DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS = record
Anonymous: _Anonymous_e__Union;
end;
DISPLAYCONFIG_TARGET_DEVICE_NAME = record
header: DISPLAYCONFIG_DEVICE_INFO_HEADER;
flags: DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS;
outputTechnology: Integer;
edidManufactureId: Word;
edidProductCodeId: Word;
connectorInstance: DWORD;
monitorFriendlyDeviceName: array[0..63] of WideChar;
monitorDevicePath: array[0..127] of WideChar;
end;const LUID = extern struct {
LowPart: u32,
HighPart: i32,
};
const DISPLAYCONFIG_DEVICE_INFO_HEADER = extern struct {
type: i32,
size: u32,
adapterId: LUID,
id: u32,
};
const DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS = extern struct {
Anonymous: _Anonymous_e__Union,
};
const DISPLAYCONFIG_TARGET_DEVICE_NAME = extern struct {
header: DISPLAYCONFIG_DEVICE_INFO_HEADER,
flags: DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS,
outputTechnology: i32,
edidManufactureId: u16,
edidProductCodeId: u16,
connectorInstance: u32,
monitorFriendlyDeviceName: [64]u16,
monitorDevicePath: [128]u16,
};type
LUID {.bycopy.} = object
LowPart: uint32
HighPart: int32
DISPLAYCONFIG_DEVICE_INFO_HEADER {.bycopy.} = object
type: int32
size: uint32
adapterId: LUID
id: uint32
DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS {.bycopy.} = object
Anonymous: _Anonymous_e__Union
DISPLAYCONFIG_TARGET_DEVICE_NAME {.bycopy.} = object
header: DISPLAYCONFIG_DEVICE_INFO_HEADER
flags: DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS
outputTechnology: int32
edidManufactureId: uint16
edidProductCodeId: uint16
connectorInstance: uint32
monitorFriendlyDeviceName: array[64, uint16]
monitorDevicePath: array[128, uint16]struct LUID
{
uint LowPart;
int HighPart;
}
struct DISPLAYCONFIG_DEVICE_INFO_HEADER
{
int type;
uint size;
LUID adapterId;
uint id;
}
struct DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS
{
_Anonymous_e__Union Anonymous;
}
struct DISPLAYCONFIG_TARGET_DEVICE_NAME
{
DISPLAYCONFIG_DEVICE_INFO_HEADER header;
DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS flags;
int outputTechnology;
ushort edidManufactureId;
ushort edidProductCodeId;
uint connectorInstance;
wchar[64] monitorFriendlyDeviceName;
wchar[128] monitorDevicePath;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DISPLAYCONFIG_TARGET_DEVICE_NAME サイズ: 420 バイト(x86)
dim st, 105 ; 4byte整数×105(構造体サイズ 420 / 4 切り上げ)
; header : DISPLAYCONFIG_DEVICE_INFO_HEADER (+0, 20byte) varptr(st)+0 を基点に操作(20byte:入れ子/配列)
; flags : DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS (+20, 4byte) varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; outputTechnology : DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; edidManufactureId : WORD (+28, 2byte) wpoke st,28,値 / 値 = wpeek(st,28)
; edidProductCodeId : WORD (+30, 2byte) wpoke st,30,値 / 値 = wpeek(st,30)
; connectorInstance : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; monitorFriendlyDeviceName : WCHAR (+36, 128byte) varptr(st)+36 を基点に操作(128byte:入れ子/配列)
; monitorDevicePath : WCHAR (+164, 256byte) varptr(st)+164 を基点に操作(256byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DISPLAYCONFIG_TARGET_DEVICE_NAME サイズ: 432 バイト(x64)
dim st, 108 ; 4byte整数×108(構造体サイズ 432 / 4 切り上げ)
; header : DISPLAYCONFIG_DEVICE_INFO_HEADER (+0, 20byte) varptr(st)+0 を基点に操作(20byte:入れ子/配列)
; flags : DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; outputTechnology : DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; edidManufactureId : WORD (+36, 2byte) wpoke st,36,値 / 値 = wpeek(st,36)
; edidProductCodeId : WORD (+38, 2byte) wpoke st,38,値 / 値 = wpeek(st,38)
; connectorInstance : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; monitorFriendlyDeviceName : WCHAR (+44, 128byte) varptr(st)+44 を基点に操作(128byte:入れ子/配列)
; monitorDevicePath : WCHAR (+172, 256byte) varptr(st)+172 を基点に操作(256byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global LUID
#field int LowPart
#field int HighPart
#endstruct
#defstruct global DISPLAYCONFIG_DEVICE_INFO_HEADER
#field int type
#field int size
#field LUID adapterId
#field int id
#endstruct
#defstruct global DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS
#field byte Anonymous 8
#endstruct
#defstruct global DISPLAYCONFIG_TARGET_DEVICE_NAME
#field DISPLAYCONFIG_DEVICE_INFO_HEADER header
#field DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS flags
#field int outputTechnology
#field short edidManufactureId
#field short edidProductCodeId
#field int connectorInstance
#field wchar monitorFriendlyDeviceName 64
#field wchar monitorDevicePath 128
#endstruct
stdim st, DISPLAYCONFIG_TARGET_DEVICE_NAME ; NSTRUCT 変数を確保
st->outputTechnology = 100
mes "outputTechnology=" + st->outputTechnology