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

DDRAWI_DDRAWSURFACE_GBL

構造体
サイズx64: 104 バイト / x86: 72 バイト

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

フィールド

フィールドサイズx64x86説明
dwRefCntDWORD4+0+0グローバルサーフェスオブジェクトの参照カウントを示す。
dwGlobalFlagsDWORD4+4+4サーフェスのグローバル属性を示すフラグを示す。
Anonymous1_Anonymous1_e__Union8/4+8+8アクセス矩形リストまたはアロケーション基準値を保持する共用体。
Anonymous2_Anonymous2_e__Union8/4+16+12リンクサイズまたはピッチを保持する共用体。
Anonymous3_Anonymous3_e__Union8/4+24+16バックバッファ数またはミップマップ数を保持する共用体。
fpVidMemUINT_PTR8/4+32+20サーフェスのビデオメモリ開始アドレス(オフセット)を示す。
Anonymous4_Anonymous4_e__Union4+40+24ピッチ/リンクされたサーフェス/ヒープ情報を保持する共用体。
wHeightWORD2+44+28サーフェスの高さ(ピクセル)を示す。
wWidthWORD2+46+30サーフェスの幅(ピクセル)を示す。
dwUsageCountDWORD4+48+32サーフェスの使用カウントを示す。
dwReserved1UINT_PTR8/4+56+36予約フィールド。0とする。
ddpfSurfaceDDPIXELFORMAT40/32+64+40サーフェスのピクセル形式(DDPIXELFORMAT)。

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

フィールドサイズx64x86
lpRectListACCESSRECTLIST*8/4+0+0
dwBlockSizeYDWORD4+0+0
lSlicePitchINT4+0+0

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

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

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

フィールドサイズx64x86
lpDDDDRAWI_DIRECTDRAW_GBL*8/4+0+0
lpDDHandlevoid*8/4+0+0

共用体: _Anonymous4_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;

// DDRAWI_DDRAWSURFACE_GBL  (x64 104 / x86 72 バイト)
typedef struct DDRAWI_DDRAWSURFACE_GBL {
    DWORD dwRefCnt;
    DWORD dwGlobalFlags;
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    _Anonymous3_e__Union Anonymous3;
    UINT_PTR fpVidMem;
    _Anonymous4_e__Union Anonymous4;
    WORD wHeight;
    WORD wWidth;
    DWORD dwUsageCount;
    UINT_PTR dwReserved1;
    DDPIXELFORMAT ddpfSurface;
} DDRAWI_DDRAWSURFACE_GBL;
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 DDRAWI_DDRAWSURFACE_GBL
{
    public uint dwRefCnt;
    public uint dwGlobalFlags;
    public _Anonymous1_e__Union Anonymous1;
    public _Anonymous2_e__Union Anonymous2;
    public _Anonymous3_e__Union Anonymous3;
    public UIntPtr fpVidMem;
    public _Anonymous4_e__Union Anonymous4;
    public ushort wHeight;
    public ushort wWidth;
    public uint dwUsageCount;
    public UIntPtr dwReserved1;
    public DDPIXELFORMAT ddpfSurface;
}
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 DDRAWI_DDRAWSURFACE_GBL
    Public dwRefCnt As UInteger
    Public dwGlobalFlags As UInteger
    Public Anonymous1 As _Anonymous1_e__Union
    Public Anonymous2 As _Anonymous2_e__Union
    Public Anonymous3 As _Anonymous3_e__Union
    Public fpVidMem As UIntPtr
    Public Anonymous4 As _Anonymous4_e__Union
    Public wHeight As UShort
    Public wWidth As UShort
    Public dwUsageCount As UInteger
    Public dwReserved1 As UIntPtr
    Public ddpfSurface As DDPIXELFORMAT
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 DDRAWI_DDRAWSURFACE_GBL(ctypes.Structure):
    _fields_ = [
        ("dwRefCnt", wintypes.DWORD),
        ("dwGlobalFlags", wintypes.DWORD),
        ("Anonymous1", _Anonymous1_e__Union),
        ("Anonymous2", _Anonymous2_e__Union),
        ("Anonymous3", _Anonymous3_e__Union),
        ("fpVidMem", ctypes.c_size_t),
        ("Anonymous4", _Anonymous4_e__Union),
        ("wHeight", ctypes.c_ushort),
        ("wWidth", ctypes.c_ushort),
        ("dwUsageCount", wintypes.DWORD),
        ("dwReserved1", ctypes.c_size_t),
        ("ddpfSurface", DDPIXELFORMAT),
    ]
#[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 DDRAWI_DDRAWSURFACE_GBL {
    pub dwRefCnt: u32,
    pub dwGlobalFlags: u32,
    pub Anonymous1: _Anonymous1_e__Union,
    pub Anonymous2: _Anonymous2_e__Union,
    pub Anonymous3: _Anonymous3_e__Union,
    pub fpVidMem: usize,
    pub Anonymous4: _Anonymous4_e__Union,
    pub wHeight: u16,
    pub wWidth: u16,
    pub dwUsageCount: u32,
    pub dwReserved1: usize,
    pub ddpfSurface: DDPIXELFORMAT,
}
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 DDRAWI_DDRAWSURFACE_GBL struct {
	dwRefCnt uint32
	dwGlobalFlags uint32
	Anonymous1 _Anonymous1_e__Union
	Anonymous2 _Anonymous2_e__Union
	Anonymous3 _Anonymous3_e__Union
	fpVidMem uintptr
	Anonymous4 _Anonymous4_e__Union
	wHeight uint16
	wWidth uint16
	dwUsageCount uint32
	dwReserved1 uintptr
	ddpfSurface DDPIXELFORMAT
}
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;

  DDRAWI_DDRAWSURFACE_GBL = record
    dwRefCnt: DWORD;
    dwGlobalFlags: DWORD;
    Anonymous1: _Anonymous1_e__Union;
    Anonymous2: _Anonymous2_e__Union;
    Anonymous3: _Anonymous3_e__Union;
    fpVidMem: NativeUInt;
    Anonymous4: _Anonymous4_e__Union;
    wHeight: Word;
    wWidth: Word;
    dwUsageCount: DWORD;
    dwReserved1: NativeUInt;
    ddpfSurface: DDPIXELFORMAT;
  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 DDRAWI_DDRAWSURFACE_GBL = extern struct {
    dwRefCnt: u32,
    dwGlobalFlags: u32,
    Anonymous1: _Anonymous1_e__Union,
    Anonymous2: _Anonymous2_e__Union,
    Anonymous3: _Anonymous3_e__Union,
    fpVidMem: usize,
    Anonymous4: _Anonymous4_e__Union,
    wHeight: u16,
    wWidth: u16,
    dwUsageCount: u32,
    dwReserved1: usize,
    ddpfSurface: DDPIXELFORMAT,
};
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

  DDRAWI_DDRAWSURFACE_GBL {.bycopy.} = object
    dwRefCnt: uint32
    dwGlobalFlags: uint32
    Anonymous1: _Anonymous1_e__Union
    Anonymous2: _Anonymous2_e__Union
    Anonymous3: _Anonymous3_e__Union
    fpVidMem: uint
    Anonymous4: _Anonymous4_e__Union
    wHeight: uint16
    wWidth: uint16
    dwUsageCount: uint32
    dwReserved1: uint
    ddpfSurface: DDPIXELFORMAT
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 DDRAWI_DDRAWSURFACE_GBL
{
    uint dwRefCnt;
    uint dwGlobalFlags;
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    _Anonymous3_e__Union Anonymous3;
    size_t fpVidMem;
    _Anonymous4_e__Union Anonymous4;
    ushort wHeight;
    ushort wWidth;
    uint dwUsageCount;
    size_t dwReserved1;
    DDPIXELFORMAT ddpfSurface;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DDRAWI_DDRAWSURFACE_GBL サイズ: 72 バイト(x86)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; dwRefCnt : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwGlobalFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Anonymous1 : _Anonymous1_e__Union (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; Anonymous2 : _Anonymous2_e__Union (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; Anonymous3 : _Anonymous3_e__Union (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; fpVidMem : UINT_PTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Anonymous4 : _Anonymous4_e__Union (+24, 4byte)  varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; wHeight : WORD (+28, 2byte)  wpoke st,28,値  /  値 = wpeek(st,28)
; wWidth : WORD (+30, 2byte)  wpoke st,30,値  /  値 = wpeek(st,30)
; dwUsageCount : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwReserved1 : UINT_PTR (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ddpfSurface : DDPIXELFORMAT (+40, 32byte)  varptr(st)+40 を基点に操作(32byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DDRAWI_DDRAWSURFACE_GBL サイズ: 104 バイト(x64)
dim st, 26    ; 4byte整数×26(構造体サイズ 104 / 4 切り上げ)
; dwRefCnt : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwGlobalFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Anonymous1 : _Anonymous1_e__Union (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; Anonymous2 : _Anonymous2_e__Union (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; Anonymous3 : _Anonymous3_e__Union (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; fpVidMem : UINT_PTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; Anonymous4 : _Anonymous4_e__Union (+40, 4byte)  varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; wHeight : WORD (+44, 2byte)  wpoke st,44,値  /  値 = wpeek(st,44)
; wWidth : WORD (+46, 2byte)  wpoke st,46,値  /  値 = wpeek(st,46)
; dwUsageCount : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwReserved1 : UINT_PTR (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ddpfSurface : DDPIXELFORMAT (+64, 40byte)  varptr(st)+64 を基点に操作(40byte:入れ子/配列)
; ※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 DDRAWI_DDRAWSURFACE_GBL
    #field int dwRefCnt
    #field int dwGlobalFlags
    #field byte Anonymous1 8
    #field byte Anonymous2 8
    #field byte Anonymous3 8
    #field intptr fpVidMem
    #field byte Anonymous4 4
    #field short wHeight
    #field short wWidth
    #field int dwUsageCount
    #field intptr dwReserved1
    #field DDPIXELFORMAT ddpfSurface
#endstruct

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