Win32 API 日本語リファレンス
ホーム › Graphics.CompositionSwapchain › CompositionFrameDisplayInstance

CompositionFrameDisplayInstance

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 60 バイト / x86: 60 バイト

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

フィールド

フィールド型サイズx64x86説明
displayAdapterLUIDLUID8+0+0表示を行うアダプタのLUID。
displayVidPnSourceIdDWORD4+8+8表示元のVidPNソースID。
displayUniqueIdDWORD4+12+12ディスプレイを一意に識別するID。
renderAdapterLUIDLUID8+16+16描画を行うアダプタのLUID。
instanceKindCompositionFrameInstanceKind4+24+24フレームインスタンスの種別を示す列挙値。
finalTransformPresentationTransform24+28+28適用される最終的な変換を表すPresentationTransform。
requiredCrossAdapterCopyBYTE1+52+52アダプタ間コピーが必要かを示す真偽値。
colorSpaceDXGI_COLOR_SPACE_TYPE4+56+56出力の色空間を示すDXGI_COLOR_SPACE_TYPE。

各言語での定義

#include <windows.h>

// LUID  (x64 8 / x86 8 バイト)
typedef struct LUID {
    DWORD LowPart;
    INT HighPart;
} LUID;

// PresentationTransform  (x64 24 / x86 24 バイト)
typedef struct PresentationTransform {
    FLOAT M11;
    FLOAT M12;
    FLOAT M21;
    FLOAT M22;
    FLOAT M31;
    FLOAT M32;
} PresentationTransform;

// CompositionFrameDisplayInstance  (x64 60 / x86 60 バイト)
typedef struct CompositionFrameDisplayInstance {
    LUID displayAdapterLUID;
    DWORD displayVidPnSourceId;
    DWORD displayUniqueId;
    LUID renderAdapterLUID;
    CompositionFrameInstanceKind instanceKind;
    PresentationTransform finalTransform;
    BYTE requiredCrossAdapterCopy;
    DXGI_COLOR_SPACE_TYPE colorSpace;
} CompositionFrameDisplayInstance;
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 PresentationTransform
{
    public float M11;
    public float M12;
    public float M21;
    public float M22;
    public float M31;
    public float M32;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CompositionFrameDisplayInstance
{
    public LUID displayAdapterLUID;
    public uint displayVidPnSourceId;
    public uint displayUniqueId;
    public LUID renderAdapterLUID;
    public int instanceKind;
    public PresentationTransform finalTransform;
    public byte requiredCrossAdapterCopy;
    public int colorSpace;
}
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 PresentationTransform
    Public M11 As Single
    Public M12 As Single
    Public M21 As Single
    Public M22 As Single
    Public M31 As Single
    Public M32 As Single
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CompositionFrameDisplayInstance
    Public displayAdapterLUID As LUID
    Public displayVidPnSourceId As UInteger
    Public displayUniqueId As UInteger
    Public renderAdapterLUID As LUID
    Public instanceKind As Integer
    Public finalTransform As PresentationTransform
    Public requiredCrossAdapterCopy As Byte
    Public colorSpace As Integer
End Structure
import ctypes
from ctypes import wintypes

class LUID(ctypes.Structure):
    _fields_ = [
        ("LowPart", wintypes.DWORD),
        ("HighPart", ctypes.c_int),
    ]

class PresentationTransform(ctypes.Structure):
    _fields_ = [
        ("M11", ctypes.c_float),
        ("M12", ctypes.c_float),
        ("M21", ctypes.c_float),
        ("M22", ctypes.c_float),
        ("M31", ctypes.c_float),
        ("M32", ctypes.c_float),
    ]

class CompositionFrameDisplayInstance(ctypes.Structure):
    _fields_ = [
        ("displayAdapterLUID", LUID),
        ("displayVidPnSourceId", wintypes.DWORD),
        ("displayUniqueId", wintypes.DWORD),
        ("renderAdapterLUID", LUID),
        ("instanceKind", ctypes.c_int),
        ("finalTransform", PresentationTransform),
        ("requiredCrossAdapterCopy", ctypes.c_ubyte),
        ("colorSpace", ctypes.c_int),
    ]
#[repr(C)]
pub struct LUID {
    pub LowPart: u32,
    pub HighPart: i32,
}

#[repr(C)]
pub struct PresentationTransform {
    pub M11: f32,
    pub M12: f32,
    pub M21: f32,
    pub M22: f32,
    pub M31: f32,
    pub M32: f32,
}

#[repr(C)]
pub struct CompositionFrameDisplayInstance {
    pub displayAdapterLUID: LUID,
    pub displayVidPnSourceId: u32,
    pub displayUniqueId: u32,
    pub renderAdapterLUID: LUID,
    pub instanceKind: i32,
    pub finalTransform: PresentationTransform,
    pub requiredCrossAdapterCopy: u8,
    pub colorSpace: i32,
}
import "golang.org/x/sys/windows"

type LUID struct {
	LowPart uint32
	HighPart int32
}

type PresentationTransform struct {
	M11 float32
	M12 float32
	M21 float32
	M22 float32
	M31 float32
	M32 float32
}

type CompositionFrameDisplayInstance struct {
	displayAdapterLUID LUID
	displayVidPnSourceId uint32
	displayUniqueId uint32
	renderAdapterLUID LUID
	instanceKind int32
	finalTransform PresentationTransform
	requiredCrossAdapterCopy byte
	colorSpace int32
}
type
  LUID = record
    LowPart: DWORD;
    HighPart: Integer;
  end;

  PresentationTransform = record
    M11: Single;
    M12: Single;
    M21: Single;
    M22: Single;
    M31: Single;
    M32: Single;
  end;

  CompositionFrameDisplayInstance = record
    displayAdapterLUID: LUID;
    displayVidPnSourceId: DWORD;
    displayUniqueId: DWORD;
    renderAdapterLUID: LUID;
    instanceKind: Integer;
    finalTransform: PresentationTransform;
    requiredCrossAdapterCopy: Byte;
    colorSpace: Integer;
  end;
const LUID = extern struct {
    LowPart: u32,
    HighPart: i32,
};

const PresentationTransform = extern struct {
    M11: f32,
    M12: f32,
    M21: f32,
    M22: f32,
    M31: f32,
    M32: f32,
};

const CompositionFrameDisplayInstance = extern struct {
    displayAdapterLUID: LUID,
    displayVidPnSourceId: u32,
    displayUniqueId: u32,
    renderAdapterLUID: LUID,
    instanceKind: i32,
    finalTransform: PresentationTransform,
    requiredCrossAdapterCopy: u8,
    colorSpace: i32,
};
type
  LUID {.bycopy.} = object
    LowPart: uint32
    HighPart: int32

  PresentationTransform {.bycopy.} = object
    M11: float32
    M12: float32
    M21: float32
    M22: float32
    M31: float32
    M32: float32

  CompositionFrameDisplayInstance {.bycopy.} = object
    displayAdapterLUID: LUID
    displayVidPnSourceId: uint32
    displayUniqueId: uint32
    renderAdapterLUID: LUID
    instanceKind: int32
    finalTransform: PresentationTransform
    requiredCrossAdapterCopy: uint8
    colorSpace: int32
struct LUID
{
    uint LowPart;
    int HighPart;
}

struct PresentationTransform
{
    float M11;
    float M12;
    float M21;
    float M22;
    float M31;
    float M32;
}

struct CompositionFrameDisplayInstance
{
    LUID displayAdapterLUID;
    uint displayVidPnSourceId;
    uint displayUniqueId;
    LUID renderAdapterLUID;
    int instanceKind;
    PresentationTransform finalTransform;
    ubyte requiredCrossAdapterCopy;
    int colorSpace;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CompositionFrameDisplayInstance サイズ: 60 バイト(x64)
dim st, 15    ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; displayAdapterLUID : LUID (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; displayVidPnSourceId : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; displayUniqueId : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; renderAdapterLUID : LUID (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; instanceKind : CompositionFrameInstanceKind (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; finalTransform : PresentationTransform (+28, 24byte)  varptr(st)+28 を基点に操作(24byte:入れ子/配列)
; requiredCrossAdapterCopy : BYTE (+52, 1byte)  poke st,52,値  /  値 = peek(st,52)
; colorSpace : DXGI_COLOR_SPACE_TYPE (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※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 PresentationTransform
    #field float M11
    #field float M12
    #field float M21
    #field float M22
    #field float M31
    #field float M32
#endstruct

#defstruct global CompositionFrameDisplayInstance
    #field LUID displayAdapterLUID
    #field int displayVidPnSourceId
    #field int displayUniqueId
    #field LUID renderAdapterLUID
    #field int instanceKind
    #field PresentationTransform finalTransform
    #field byte requiredCrossAdapterCopy
    #field int colorSpace
#endstruct

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