ホーム › 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 等に使用)。

フィールド

型

サイズ

x64

x86

説明

Anonymous1

_Anonymous1_e__Union

利用可能なバックバッファ数またはリンク用ポインタを保持する無名共用体。

Anonymous2

_Anonymous2_e__Union

8/4

ピッチまたはリニアサイズを保持する無名共用体。

fpVidMem

UINT_PTR

8/4

+16

ドライバーがメモリブロックを割り当てる場合は、このメンバーに表示メモリ内のオフセットを返します。ドライバーがメモリの割り当てを DirectDraw に要求する場合は、代わりに DdCreateSurface ルーチンからこのメンバーに次のいずれかの値を返すことができます。

値	意味
DDHAL_PLEASEALLOC_BLOCKSIZE	DirectDraw は、オフスクリーンメモリ内に dwBlockSizeX と dwBlockSizeY のサイズのメモリブロックを割り当てます。
DDHAL_PLEASEALLOC_USERMEM	DirectDraw は、ユーザーモードメモリ内に dwUserMemSize のサイズのメモリブロックを割り当てます。

Anonymous3

_Anonymous3_e__Union

+24

+12

DirectDrawグローバルオブジェクトまたはハンドルを保持する無名共用体。

yHint

INT

+28

+16

サーフェスの y 座標を指定します。このメンバーは、デバイス空間で指定される 2 次元の直交座標です。

xHint

INT

+32

+20

サーフェスの x 座標を指定します。このメンバーは、デバイス空間で指定される 2 次元の直交座標です。

wHeight

DWORD

+36

+24

サーフェスの高さをピクセル単位で指定します。

wWidth

DWORD

+40

+28

サーフェスの幅をピクセル単位で指定します。

dwReserved1

UINT_PTR

8/4

+48

+32

ディスプレイドライバーが使用するために予約済みです。

ddpfSurface

DDPIXELFORMAT

40/32

+56

+36

サーフェスのピクセル形式を記述する DDPIXELFORMAT 構造体を指します。

fpHeapOffset

UINT_PTR

8/4

+96

+68

ソースヒープ内の生のオフセットを指します。

hCreatorProcess

HANDLE

8/4

+104

+72

システムが使用するために予約済みであり、ドライバーは無視する必要があります。

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

フィールド	型	サイズ	x64	x86	説明
dwBlockSizeY	DWORD	4	+0	+0	Microsoft DirectDraw が割り当てるオフスクリーンメモリブロックの高さ (走査線単位) を、ドライバーが返す場所を指定します。ドライバーは、fpVidMem メンバーで DDHAL_PLEASEALLOC_BLOCKSIZE を返すときに、この値を設定します。
lSlicePitch	INT	4	+0	+0	ボリュームテクスチャのスライスピッチです。

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

フィールド	型	サイズ	x64	x86	説明
lpVidMemHeap	VIDEOMEMORY*	8/4	+0	+0	ヒープの表示メモリの割り当て元となった VIDEOMEMORY 構造体を指します。
dwBlockSizeX	DWORD	4	+0	+0	DirectDraw が割り当てるオフスクリーンメモリブロックの幅のサイズ (バイト単位) を、ドライバーが返す場所を指定します。ドライバーは、fpVidMem メンバーで DDHAL_PLEASEALLOC_BLOCKSIZE を返すときに、この値を設定します。
dwUserMemSize	DWORD	4	+0	+0	DirectDraw がユーザーモードのシステムメモリに割り当てるメモリブロックのサイズ (バイト単位) を、ドライバーが返す場所を指定します。ドライバーは、fpVidMem メンバーで DDHAL_PLEASEALLOC_USERMEM を返すときに、この値を設定します。

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

フィールド	型	サイズ	x64	x86	説明
lPitch	INT	4	+0	+0	サーフェスのピッチ、つまり次の行の先頭までの距離をバイト単位で指定します。これはサーフェスのストライドとも呼ばれます。
dwLinearSize	DWORD	4	+0	+0	非矩形サーフェスの線形サイズをバイト単位で指定します。

公式ドキュメント

DD_SURFACE_GLOBAL 構造体には、複数のサーフェス間で共有できるグローバルなサーフェス関連データが格納されます。

解説(Remarks)

CreateD3DBuffer によって作成される頂点バッファーは、プリミティブのレンダリングのために D3dDrawPrimitives2 コールバックが使用する頂点のリストを保持します。Microsoft Windows は頂点バッファーを DirectDraw サーフェスとして表現し、これによって頂点バッファーと DD_SURFACE_GLOBAL 構造体の間に関連付けが確立されます。

DirectX ドライバーが頂点バッファーを扱う際には、そのバッファーのサイズを正しく判断できることが重要です。DirectDraw は、この構造体の lPitch メンバーで線形バッファーサイズをドライバーに渡します。Windows 2000 以降のバージョンでは (Windows 98/Me では該当しません)、この構造体の wWidth メンバーにも同じ値が設定されます。これらの構造体メンバーはいずれも読み取り専用と見なす必要があることに注意してください。DirectDraw がこれらのメンバーに格納する値は、頂点バッファーの最小サイズを表します。より大きなバッファーが必要になった場合 (最適化のためなど)、ドライバーの作成者はそのサイズより大きいバッファーを自由に作成できます。ただし、どのような場合でも、ドライバーがその大きいバッファーサイズを DirectDraw に報告してはなりません。

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

各言語での定義

#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 非対応)。必要に応じ手動でアクセス。

DD_SURFACE_GLOBAL

フィールド

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

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

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

公式ドキュメント

解説(Remarks)

各言語での定義

HSP用 定義

HSP用定義