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

DDHAL_GETHEAPALIGNMENTDATA

構造体
サイズx64: 96 バイト / x86: 56 バイト

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

フィールド

フィールドサイズx64x86説明
dwInstanceUINT_PTR8/4+0+0ドライバインスタンスを識別する値を示す。
dwHeapDWORD4+8+4対象とするヒープの番号を示す。
ddRValHRESULT4+12+8ヒープアライメント取得の実行結果を示すHRESULT。
GetHeapAlignmentLPDDHAL_GETHEAPALIGNMENT8/4+16+12実際のアライメント取得を行うコールバックへのポインタ。
AlignmentHEAPALIGNMENT72/40+24+16取得したヒープアライメント情報(HEAPALIGNMENT)。

各言語での定義

#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;

// DDHAL_GETHEAPALIGNMENTDATA  (x64 96 / x86 56 バイト)
typedef struct DDHAL_GETHEAPALIGNMENTDATA {
    UINT_PTR dwInstance;
    DWORD dwHeap;
    HRESULT ddRVal;
    LPDDHAL_GETHEAPALIGNMENT GetHeapAlignment;
    HEAPALIGNMENT Alignment;
} DDHAL_GETHEAPALIGNMENTDATA;
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;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDHAL_GETHEAPALIGNMENTDATA
{
    public UIntPtr dwInstance;
    public uint dwHeap;
    public int ddRVal;
    public IntPtr GetHeapAlignment;
    public HEAPALIGNMENT Alignment;
}
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

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDHAL_GETHEAPALIGNMENTDATA
    Public dwInstance As UIntPtr
    Public dwHeap As UInteger
    Public ddRVal As Integer
    Public GetHeapAlignment As IntPtr
    Public Alignment As HEAPALIGNMENT
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),
    ]

class DDHAL_GETHEAPALIGNMENTDATA(ctypes.Structure):
    _fields_ = [
        ("dwInstance", ctypes.c_size_t),
        ("dwHeap", wintypes.DWORD),
        ("ddRVal", ctypes.c_int),
        ("GetHeapAlignment", ctypes.c_void_p),
        ("Alignment", HEAPALIGNMENT),
    ]
#[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,
}

#[repr(C)]
pub struct DDHAL_GETHEAPALIGNMENTDATA {
    pub dwInstance: usize,
    pub dwHeap: u32,
    pub ddRVal: i32,
    pub GetHeapAlignment: *mut core::ffi::c_void,
    pub Alignment: HEAPALIGNMENT,
}
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 DDHAL_GETHEAPALIGNMENTDATA struct {
	dwInstance uintptr
	dwHeap uint32
	ddRVal int32
	GetHeapAlignment uintptr
	Alignment HEAPALIGNMENT
}
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;

  DDHAL_GETHEAPALIGNMENTDATA = record
    dwInstance: NativeUInt;
    dwHeap: DWORD;
    ddRVal: Integer;
    GetHeapAlignment: Pointer;
    Alignment: HEAPALIGNMENT;
  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,
};

const DDHAL_GETHEAPALIGNMENTDATA = extern struct {
    dwInstance: usize,
    dwHeap: u32,
    ddRVal: i32,
    GetHeapAlignment: ?*anyopaque,
    Alignment: HEAPALIGNMENT,
};
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

  DDHAL_GETHEAPALIGNMENTDATA {.bycopy.} = object
    dwInstance: uint
    dwHeap: uint32
    ddRVal: int32
    GetHeapAlignment: pointer
    Alignment: HEAPALIGNMENT
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;
}

struct DDHAL_GETHEAPALIGNMENTDATA
{
    size_t dwInstance;
    uint dwHeap;
    int ddRVal;
    void* GetHeapAlignment;
    HEAPALIGNMENT Alignment;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DDHAL_GETHEAPALIGNMENTDATA サイズ: 56 バイト(x86)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; dwInstance : UINT_PTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwHeap : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ddRVal : HRESULT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; GetHeapAlignment : LPDDHAL_GETHEAPALIGNMENT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Alignment : HEAPALIGNMENT (+16, 40byte)  varptr(st)+16 を基点に操作(40byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DDHAL_GETHEAPALIGNMENTDATA サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; dwInstance : UINT_PTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; dwHeap : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ddRVal : HRESULT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; GetHeapAlignment : LPDDHAL_GETHEAPALIGNMENT (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; Alignment : HEAPALIGNMENT (+24, 72byte)  varptr(st)+24 を基点に操作(72byte:入れ子/配列)
; ※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

#defstruct global DDHAL_GETHEAPALIGNMENTDATA
    #field intptr dwInstance
    #field int dwHeap
    #field int ddRVal
    #field intptr GetHeapAlignment
    #field HEAPALIGNMENT Alignment
#endstruct

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