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

HEAPALIGNMENT

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

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0構造体サイズ(バイト数)。呼び出し前に設定する。
ddsCapsDDSCAPS4+4+4対象ヒープのサーフェス能力(DDSCAPS)を示す。
dwReservedDWORD4+8+8予約フィールド。0とする。
ExecuteBufferSURFACEALIGNMENT8/4+16+12実行バッファ用のアライメント要件(SURFACEALIGNMENT)。
OverlaySURFACEALIGNMENT8/4+24+16オーバーレイ用のアライメント要件を示す。
TextureSURFACEALIGNMENT8/4+32+20テクスチャ用のアライメント要件を示す。
ZBufferSURFACEALIGNMENT8/4+40+24Zバッファ用のアライメント要件を示す。
AlphaBufferSURFACEALIGNMENT8/4+48+28アルファバッファ用のアライメント要件を示す。
OffscreenSURFACEALIGNMENT8/4+56+32オフスクリーンサーフェス用のアライメント要件を示す。
FlipTargetSURFACEALIGNMENT8/4+64+36フリップ対象サーフェス用のアライメント要件を示す。

各言語での定義

#include <windows.h>

// DDSCAPS  (x64 4 / x86 4 バイト)
typedef struct DDSCAPS {
    DWORD dwCaps;
} DDSCAPS;

// SURFACEALIGNMENT  (x64 8 / x86 4 バイト)
typedef struct SURFACEALIGNMENT {
    _Anonymous_e__Union Anonymous;
} SURFACEALIGNMENT;

// HEAPALIGNMENT  (x64 72 / x86 40 バイト)
typedef struct HEAPALIGNMENT {
    DWORD dwSize;
    DDSCAPS ddsCaps;
    DWORD dwReserved;
    SURFACEALIGNMENT ExecuteBuffer;
    SURFACEALIGNMENT Overlay;
    SURFACEALIGNMENT Texture;
    SURFACEALIGNMENT ZBuffer;
    SURFACEALIGNMENT AlphaBuffer;
    SURFACEALIGNMENT Offscreen;
    SURFACEALIGNMENT FlipTarget;
} HEAPALIGNMENT;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDSCAPS
{
    public uint dwCaps;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SURFACEALIGNMENT
{
    public _Anonymous_e__Union Anonymous;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HEAPALIGNMENT
{
    public uint dwSize;
    public DDSCAPS ddsCaps;
    public uint dwReserved;
    public SURFACEALIGNMENT ExecuteBuffer;
    public SURFACEALIGNMENT Overlay;
    public SURFACEALIGNMENT Texture;
    public SURFACEALIGNMENT ZBuffer;
    public SURFACEALIGNMENT AlphaBuffer;
    public SURFACEALIGNMENT Offscreen;
    public SURFACEALIGNMENT FlipTarget;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDSCAPS
    Public dwCaps As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SURFACEALIGNMENT
    Public Anonymous As _Anonymous_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HEAPALIGNMENT
    Public dwSize As UInteger
    Public ddsCaps As DDSCAPS
    Public dwReserved As UInteger
    Public ExecuteBuffer As SURFACEALIGNMENT
    Public Overlay As SURFACEALIGNMENT
    Public Texture As SURFACEALIGNMENT
    Public ZBuffer As SURFACEALIGNMENT
    Public AlphaBuffer As SURFACEALIGNMENT
    Public Offscreen As SURFACEALIGNMENT
    Public FlipTarget As SURFACEALIGNMENT
End Structure
import ctypes
from ctypes import wintypes

class DDSCAPS(ctypes.Structure):
    _fields_ = [
        ("dwCaps", wintypes.DWORD),
    ]

class SURFACEALIGNMENT(ctypes.Structure):
    _fields_ = [
        ("Anonymous", _Anonymous_e__Union),
    ]

class HEAPALIGNMENT(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("ddsCaps", DDSCAPS),
        ("dwReserved", wintypes.DWORD),
        ("ExecuteBuffer", SURFACEALIGNMENT),
        ("Overlay", SURFACEALIGNMENT),
        ("Texture", SURFACEALIGNMENT),
        ("ZBuffer", SURFACEALIGNMENT),
        ("AlphaBuffer", SURFACEALIGNMENT),
        ("Offscreen", SURFACEALIGNMENT),
        ("FlipTarget", SURFACEALIGNMENT),
    ]
#[repr(C)]
pub struct DDSCAPS {
    pub dwCaps: u32,
}

#[repr(C)]
pub struct SURFACEALIGNMENT {
    pub Anonymous: _Anonymous_e__Union,
}

#[repr(C)]
pub struct HEAPALIGNMENT {
    pub dwSize: u32,
    pub ddsCaps: DDSCAPS,
    pub dwReserved: u32,
    pub ExecuteBuffer: SURFACEALIGNMENT,
    pub Overlay: SURFACEALIGNMENT,
    pub Texture: SURFACEALIGNMENT,
    pub ZBuffer: SURFACEALIGNMENT,
    pub AlphaBuffer: SURFACEALIGNMENT,
    pub Offscreen: SURFACEALIGNMENT,
    pub FlipTarget: SURFACEALIGNMENT,
}
import "golang.org/x/sys/windows"

type DDSCAPS struct {
	dwCaps uint32
}

type SURFACEALIGNMENT struct {
	Anonymous _Anonymous_e__Union
}

type HEAPALIGNMENT struct {
	dwSize uint32
	ddsCaps DDSCAPS
	dwReserved uint32
	ExecuteBuffer SURFACEALIGNMENT
	Overlay SURFACEALIGNMENT
	Texture SURFACEALIGNMENT
	ZBuffer SURFACEALIGNMENT
	AlphaBuffer SURFACEALIGNMENT
	Offscreen SURFACEALIGNMENT
	FlipTarget SURFACEALIGNMENT
}
type
  DDSCAPS = record
    dwCaps: DWORD;
  end;

  SURFACEALIGNMENT = record
    Anonymous: _Anonymous_e__Union;
  end;

  HEAPALIGNMENT = record
    dwSize: DWORD;
    ddsCaps: DDSCAPS;
    dwReserved: DWORD;
    ExecuteBuffer: SURFACEALIGNMENT;
    Overlay: SURFACEALIGNMENT;
    Texture: SURFACEALIGNMENT;
    ZBuffer: SURFACEALIGNMENT;
    AlphaBuffer: SURFACEALIGNMENT;
    Offscreen: SURFACEALIGNMENT;
    FlipTarget: SURFACEALIGNMENT;
  end;
const DDSCAPS = extern struct {
    dwCaps: u32,
};

const SURFACEALIGNMENT = extern struct {
    Anonymous: _Anonymous_e__Union,
};

const HEAPALIGNMENT = extern struct {
    dwSize: u32,
    ddsCaps: DDSCAPS,
    dwReserved: u32,
    ExecuteBuffer: SURFACEALIGNMENT,
    Overlay: SURFACEALIGNMENT,
    Texture: SURFACEALIGNMENT,
    ZBuffer: SURFACEALIGNMENT,
    AlphaBuffer: SURFACEALIGNMENT,
    Offscreen: SURFACEALIGNMENT,
    FlipTarget: SURFACEALIGNMENT,
};
type
  DDSCAPS {.bycopy.} = object
    dwCaps: uint32

  SURFACEALIGNMENT {.bycopy.} = object
    Anonymous: _Anonymous_e__Union

  HEAPALIGNMENT {.bycopy.} = object
    dwSize: uint32
    ddsCaps: DDSCAPS
    dwReserved: uint32
    ExecuteBuffer: SURFACEALIGNMENT
    Overlay: SURFACEALIGNMENT
    Texture: SURFACEALIGNMENT
    ZBuffer: SURFACEALIGNMENT
    AlphaBuffer: SURFACEALIGNMENT
    Offscreen: SURFACEALIGNMENT
    FlipTarget: SURFACEALIGNMENT
struct DDSCAPS
{
    uint dwCaps;
}

struct SURFACEALIGNMENT
{
    _Anonymous_e__Union Anonymous;
}

struct HEAPALIGNMENT
{
    uint dwSize;
    DDSCAPS ddsCaps;
    uint dwReserved;
    SURFACEALIGNMENT ExecuteBuffer;
    SURFACEALIGNMENT Overlay;
    SURFACEALIGNMENT Texture;
    SURFACEALIGNMENT ZBuffer;
    SURFACEALIGNMENT AlphaBuffer;
    SURFACEALIGNMENT Offscreen;
    SURFACEALIGNMENT FlipTarget;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; HEAPALIGNMENT サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ddsCaps : DDSCAPS (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; dwReserved : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ExecuteBuffer : SURFACEALIGNMENT (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; Overlay : SURFACEALIGNMENT (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; Texture : SURFACEALIGNMENT (+20, 4byte)  varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; ZBuffer : SURFACEALIGNMENT (+24, 4byte)  varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; AlphaBuffer : SURFACEALIGNMENT (+28, 4byte)  varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; Offscreen : SURFACEALIGNMENT (+32, 4byte)  varptr(st)+32 を基点に操作(4byte:入れ子/配列)
; FlipTarget : SURFACEALIGNMENT (+36, 4byte)  varptr(st)+36 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HEAPALIGNMENT サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ddsCaps : DDSCAPS (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; dwReserved : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ExecuteBuffer : SURFACEALIGNMENT (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; Overlay : SURFACEALIGNMENT (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; Texture : SURFACEALIGNMENT (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; ZBuffer : SURFACEALIGNMENT (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; AlphaBuffer : SURFACEALIGNMENT (+48, 8byte)  varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; Offscreen : SURFACEALIGNMENT (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; FlipTarget : SURFACEALIGNMENT (+64, 8byte)  varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DDSCAPS
    #field int dwCaps
#endstruct

#defstruct global SURFACEALIGNMENT
    #field byte Anonymous 8
#endstruct

#defstruct global HEAPALIGNMENT
    #field int dwSize
    #field DDSCAPS ddsCaps
    #field int dwReserved
    #field SURFACEALIGNMENT ExecuteBuffer
    #field SURFACEALIGNMENT Overlay
    #field SURFACEALIGNMENT Texture
    #field SURFACEALIGNMENT ZBuffer
    #field SURFACEALIGNMENT AlphaBuffer
    #field SURFACEALIGNMENT Offscreen
    #field SURFACEALIGNMENT FlipTarget
#endstruct

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