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

HEAPALIGNMENT

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

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

フィールド

フィールド型サイズx64x86説明
dwSizeDWORD4+0+0この HEAPALIGNMENT 構造体のサイズをバイト単位で指定します。
ddsCapsDDSCAPS4+4+4どのアライメント フィールドが有効であるかを示す DDSCAPS 構造体を指定します。
dwReservedDWORD4+8+8システムで使用するために予約済みです。
ExecuteBufferSURFACEALIGNMENT8/4+16+12DDSCAPS_EXECUTEBUFFER が指定されたサーフェスのヒープ アライメント要件を格納する SURFACEALIGNMENT 構造体を指定します。
OverlaySURFACEALIGNMENT8/4+24+16DDSCAPS_OVERLAY が指定されたサーフェスのヒープ アライメント要件を格納する SURFACEALIGNMENT 構造体を指定します。
TextureSURFACEALIGNMENT8/4+32+20DDSCAPS_TEXTURE が指定されたサーフェスのヒープ アライメント要件を格納する SURFACEALIGNMENT 構造体を指定します。
ZBufferSURFACEALIGNMENT8/4+40+24DDSCAPS_ZBUFFER が指定されたサーフェスのヒープ アライメント要件を格納する SURFACEALIGNMENT 構造体を指定します。
AlphaBufferSURFACEALIGNMENT8/4+48+28DDSCAPS_ALPHA が指定されたサーフェスのヒープ アライメント要件を格納する SURFACEALIGNMENT 構造体を指定します。
OffscreenSURFACEALIGNMENT8/4+56+32DDSCAPS_OFFSCREENPLAIN が指定されたサーフェスのヒープ アライメント要件を格納する SURFACEALIGNMENT 構造体を指定します。
FlipTargetSURFACEALIGNMENT8/4+64+36DDSCAPS_FLIP が指定されたサーフェスのヒープ アライメント要件を格納する SURFACEALIGNMENT 構造体を指定します。

公式ドキュメント

HEAPALIGNMENT 構造体は、指定された表示メモリヒープのアライメント要件を指定するデータを格納します。

解説(Remarks)

ドライバーは、dwSize メンバーが少なくとも sizeof(HEAPALIGNMENT) 以上であることを検証する必要があります。

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

各言語での定義

#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