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

DD_SURFACE_GLOBAL

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

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

フィールド

フィールド型サイズx64x86説明
Anonymous1_Anonymous1_e__Union4+0+0利用可能なバックバッファ数またはリンク用ポインタを保持する無名共用体。
Anonymous2_Anonymous2_e__Union8/4+8+4ピッチまたはリニアサイズを保持する無名共用体。
fpVidMemUINT_PTR8/4+16+8サーフェスデータのビデオメモリ先頭フラットアドレス(またはオフセット)。
Anonymous3_Anonymous3_e__Union4+24+12DirectDrawグローバルオブジェクトまたはハンドルを保持する無名共用体。
yHintINT4+28+16サーフェス配置のY座標ヒント。
xHintINT4+32+20サーフェス配置のX座標ヒント。
wHeightDWORD4+36+24サーフェスの高さをピクセル単位で示す。
wWidthDWORD4+40+28サーフェスの幅をピクセル単位で示す。
dwReserved1UINT_PTR8/4+48+32将来の使用のために予約されたフィールド。
ddpfSurfaceDDPIXELFORMAT40/32+56+36サーフェスのピクセル形式を示すDDPIXELFORMAT。
fpHeapOffsetUINT_PTR8/4+96+68所属ヒープ内でのサーフェスのオフセットをバイト単位で示す。
hCreatorProcessHANDLE8/4+104+72このサーフェスを作成したプロセスのハンドル。

共用体: _Anonymous1_e__Union x64 4B / x86 4B

フィールド型サイズx64x86
dwBlockSizeYDWORD4+0+0
lSlicePitchINT4+0+0

共用体: _Anonymous2_e__Union x64 8B / x86 4B

フィールド型サイズx64x86
lpVidMemHeapVIDEOMEMORY*8/4+0+0
dwBlockSizeXDWORD4+0+0
dwUserMemSizeDWORD4+0+0

共用体: _Anonymous3_e__Union x64 4B / x86 4B

フィールド型サイズx64x86
lPitchINT4+0+0
dwLinearSizeDWORD4+0+0

各言語での定義

#include <windows.h>

// DDPIXELFORMAT  (x64 40 / x86 32 バイト)
typedef struct DDPIXELFORMAT {
    DWORD dwSize;
    DWORD dwFlags;
    DWORD dwFourCC;
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    _Anonymous3_e__Union Anonymous3;
    _Anonymous4_e__Union Anonymous4;
    _Anonymous5_e__Union Anonymous5;
} DDPIXELFORMAT;

// DD_SURFACE_GLOBAL  (x64 112 / x86 76 バイト)
typedef struct DD_SURFACE_GLOBAL {
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    UINT_PTR fpVidMem;
    _Anonymous3_e__Union Anonymous3;
    INT yHint;
    INT xHint;
    DWORD wHeight;
    DWORD wWidth;
    UINT_PTR dwReserved1;
    DDPIXELFORMAT ddpfSurface;
    UINT_PTR fpHeapOffset;
    HANDLE hCreatorProcess;
} DD_SURFACE_GLOBAL;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDPIXELFORMAT
{
    public uint dwSize;
    public uint dwFlags;
    public uint dwFourCC;
    public _Anonymous1_e__Union Anonymous1;
    public _Anonymous2_e__Union Anonymous2;
    public _Anonymous3_e__Union Anonymous3;
    public _Anonymous4_e__Union Anonymous4;
    public _Anonymous5_e__Union Anonymous5;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_SURFACE_GLOBAL
{
    public _Anonymous1_e__Union Anonymous1;
    public _Anonymous2_e__Union Anonymous2;
    public UIntPtr fpVidMem;
    public _Anonymous3_e__Union Anonymous3;
    public int yHint;
    public int xHint;
    public uint wHeight;
    public uint wWidth;
    public UIntPtr dwReserved1;
    public DDPIXELFORMAT ddpfSurface;
    public UIntPtr fpHeapOffset;
    public IntPtr hCreatorProcess;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDPIXELFORMAT
    Public dwSize As UInteger
    Public dwFlags As UInteger
    Public dwFourCC As UInteger
    Public Anonymous1 As _Anonymous1_e__Union
    Public Anonymous2 As _Anonymous2_e__Union
    Public Anonymous3 As _Anonymous3_e__Union
    Public Anonymous4 As _Anonymous4_e__Union
    Public Anonymous5 As _Anonymous5_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_SURFACE_GLOBAL
    Public Anonymous1 As _Anonymous1_e__Union
    Public Anonymous2 As _Anonymous2_e__Union
    Public fpVidMem As UIntPtr
    Public Anonymous3 As _Anonymous3_e__Union
    Public yHint As Integer
    Public xHint As Integer
    Public wHeight As UInteger
    Public wWidth As UInteger
    Public dwReserved1 As UIntPtr
    Public ddpfSurface As DDPIXELFORMAT
    Public fpHeapOffset As UIntPtr
    Public hCreatorProcess As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DDPIXELFORMAT(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("dwFourCC", wintypes.DWORD),
        ("Anonymous1", _Anonymous1_e__Union),
        ("Anonymous2", _Anonymous2_e__Union),
        ("Anonymous3", _Anonymous3_e__Union),
        ("Anonymous4", _Anonymous4_e__Union),
        ("Anonymous5", _Anonymous5_e__Union),
    ]

class DD_SURFACE_GLOBAL(ctypes.Structure):
    _fields_ = [
        ("Anonymous1", _Anonymous1_e__Union),
        ("Anonymous2", _Anonymous2_e__Union),
        ("fpVidMem", ctypes.c_size_t),
        ("Anonymous3", _Anonymous3_e__Union),
        ("yHint", ctypes.c_int),
        ("xHint", ctypes.c_int),
        ("wHeight", wintypes.DWORD),
        ("wWidth", wintypes.DWORD),
        ("dwReserved1", ctypes.c_size_t),
        ("ddpfSurface", DDPIXELFORMAT),
        ("fpHeapOffset", ctypes.c_size_t),
        ("hCreatorProcess", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DDPIXELFORMAT {
    pub dwSize: u32,
    pub dwFlags: u32,
    pub dwFourCC: u32,
    pub Anonymous1: _Anonymous1_e__Union,
    pub Anonymous2: _Anonymous2_e__Union,
    pub Anonymous3: _Anonymous3_e__Union,
    pub Anonymous4: _Anonymous4_e__Union,
    pub Anonymous5: _Anonymous5_e__Union,
}

#[repr(C)]
pub struct DD_SURFACE_GLOBAL {
    pub Anonymous1: _Anonymous1_e__Union,
    pub Anonymous2: _Anonymous2_e__Union,
    pub fpVidMem: usize,
    pub Anonymous3: _Anonymous3_e__Union,
    pub yHint: i32,
    pub xHint: i32,
    pub wHeight: u32,
    pub wWidth: u32,
    pub dwReserved1: usize,
    pub ddpfSurface: DDPIXELFORMAT,
    pub fpHeapOffset: usize,
    pub hCreatorProcess: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DDPIXELFORMAT struct {
	dwSize uint32
	dwFlags uint32
	dwFourCC uint32
	Anonymous1 _Anonymous1_e__Union
	Anonymous2 _Anonymous2_e__Union
	Anonymous3 _Anonymous3_e__Union
	Anonymous4 _Anonymous4_e__Union
	Anonymous5 _Anonymous5_e__Union
}

type DD_SURFACE_GLOBAL struct {
	Anonymous1 _Anonymous1_e__Union
	Anonymous2 _Anonymous2_e__Union
	fpVidMem uintptr
	Anonymous3 _Anonymous3_e__Union
	yHint int32
	xHint int32
	wHeight uint32
	wWidth uint32
	dwReserved1 uintptr
	ddpfSurface DDPIXELFORMAT
	fpHeapOffset uintptr
	hCreatorProcess uintptr
}
type
  DDPIXELFORMAT = record
    dwSize: DWORD;
    dwFlags: DWORD;
    dwFourCC: DWORD;
    Anonymous1: _Anonymous1_e__Union;
    Anonymous2: _Anonymous2_e__Union;
    Anonymous3: _Anonymous3_e__Union;
    Anonymous4: _Anonymous4_e__Union;
    Anonymous5: _Anonymous5_e__Union;
  end;

  DD_SURFACE_GLOBAL = record
    Anonymous1: _Anonymous1_e__Union;
    Anonymous2: _Anonymous2_e__Union;
    fpVidMem: NativeUInt;
    Anonymous3: _Anonymous3_e__Union;
    yHint: Integer;
    xHint: Integer;
    wHeight: DWORD;
    wWidth: DWORD;
    dwReserved1: NativeUInt;
    ddpfSurface: DDPIXELFORMAT;
    fpHeapOffset: NativeUInt;
    hCreatorProcess: Pointer;
  end;
const DDPIXELFORMAT = extern struct {
    dwSize: u32,
    dwFlags: u32,
    dwFourCC: u32,
    Anonymous1: _Anonymous1_e__Union,
    Anonymous2: _Anonymous2_e__Union,
    Anonymous3: _Anonymous3_e__Union,
    Anonymous4: _Anonymous4_e__Union,
    Anonymous5: _Anonymous5_e__Union,
};

const DD_SURFACE_GLOBAL = extern struct {
    Anonymous1: _Anonymous1_e__Union,
    Anonymous2: _Anonymous2_e__Union,
    fpVidMem: usize,
    Anonymous3: _Anonymous3_e__Union,
    yHint: i32,
    xHint: i32,
    wHeight: u32,
    wWidth: u32,
    dwReserved1: usize,
    ddpfSurface: DDPIXELFORMAT,
    fpHeapOffset: usize,
    hCreatorProcess: ?*anyopaque,
};
type
  DDPIXELFORMAT {.bycopy.} = object
    dwSize: uint32
    dwFlags: uint32
    dwFourCC: uint32
    Anonymous1: _Anonymous1_e__Union
    Anonymous2: _Anonymous2_e__Union
    Anonymous3: _Anonymous3_e__Union
    Anonymous4: _Anonymous4_e__Union
    Anonymous5: _Anonymous5_e__Union

  DD_SURFACE_GLOBAL {.bycopy.} = object
    Anonymous1: _Anonymous1_e__Union
    Anonymous2: _Anonymous2_e__Union
    fpVidMem: uint
    Anonymous3: _Anonymous3_e__Union
    yHint: int32
    xHint: int32
    wHeight: uint32
    wWidth: uint32
    dwReserved1: uint
    ddpfSurface: DDPIXELFORMAT
    fpHeapOffset: uint
    hCreatorProcess: pointer
struct DDPIXELFORMAT
{
    uint dwSize;
    uint dwFlags;
    uint dwFourCC;
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    _Anonymous3_e__Union Anonymous3;
    _Anonymous4_e__Union Anonymous4;
    _Anonymous5_e__Union Anonymous5;
}

struct DD_SURFACE_GLOBAL
{
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    size_t fpVidMem;
    _Anonymous3_e__Union Anonymous3;
    int yHint;
    int xHint;
    uint wHeight;
    uint wWidth;
    size_t dwReserved1;
    DDPIXELFORMAT ddpfSurface;
    size_t fpHeapOffset;
    void* hCreatorProcess;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_SURFACE_GLOBAL サイズ: 76 バイト(x86)
dim st, 19    ; 4byte整数×19(構造体サイズ 76 / 4 切り上げ)
; Anonymous1 : _Anonymous1_e__Union (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; Anonymous2 : _Anonymous2_e__Union (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; fpVidMem : UINT_PTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; Anonymous3 : _Anonymous3_e__Union (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; yHint : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; xHint : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; wHeight : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; wWidth : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwReserved1 : UINT_PTR (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ddpfSurface : DDPIXELFORMAT (+36, 32byte)  varptr(st)+36 を基点に操作(32byte:入れ子/配列)
; fpHeapOffset : UINT_PTR (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; hCreatorProcess : HANDLE (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_SURFACE_GLOBAL サイズ: 112 バイト(x64)
dim st, 28    ; 4byte整数×28(構造体サイズ 112 / 4 切り上げ)
; Anonymous1 : _Anonymous1_e__Union (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; Anonymous2 : _Anonymous2_e__Union (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; fpVidMem : UINT_PTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; Anonymous3 : _Anonymous3_e__Union (+24, 4byte)  varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; yHint : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; xHint : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; wHeight : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; wWidth : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwReserved1 : UINT_PTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ddpfSurface : DDPIXELFORMAT (+56, 40byte)  varptr(st)+56 を基点に操作(40byte:入れ子/配列)
; fpHeapOffset : UINT_PTR (+96, 8byte)  qpoke st,96,値 / qpeek(st,96)  ※IronHSPのみ。3.7/3.8は lpoke st,96,下位 : lpoke st,100,上位
; hCreatorProcess : HANDLE (+104, 8byte)  qpoke st,104,値 / qpeek(st,104)  ※IronHSPのみ。3.7/3.8は lpoke st,104,下位 : lpoke st,108,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DDPIXELFORMAT
    #field int dwSize
    #field int dwFlags
    #field int dwFourCC
    #field byte Anonymous1 4
    #field byte Anonymous2 4
    #field byte Anonymous3 8
    #field byte Anonymous4 4
    #field byte Anonymous5 4
#endstruct

#defstruct global DD_SURFACE_GLOBAL
    #field byte Anonymous1 4
    #field byte Anonymous2 8
    #field intptr fpVidMem
    #field byte Anonymous3 4
    #field int yHint
    #field int xHint
    #field int wHeight
    #field int wWidth
    #field intptr dwReserved1
    #field DDPIXELFORMAT ddpfSurface
    #field intptr fpHeapOffset
    #field intptr hCreatorProcess
#endstruct

stdim st, DD_SURFACE_GLOBAL        ; NSTRUCT 変数を確保
st->fpVidMem = 100
mes "fpVidMem=" + st->fpVidMem
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。