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

DDHAL_SYNCSURFACEDATA

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

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズをバイト単位で示す。
lpDDDDRAWI_DIRECTDRAW_LCL*8/4+8+4対象のDirectDrawローカルオブジェクトへのポインタ。
lpDDSurfaceDDRAWI_DDRAWSURFACE_LCL*8/4+16+8同期対象となるサーフェスのローカルオブジェクトへのポインタ。
dwSurfaceOffsetDWORD4+24+12ビデオメモリ先頭からのサーフェスデータのオフセットをバイト単位で示す。
fpLockPtrUINT_PTR8/4+32+16ロックされたサーフェスメモリへのポインタ(フラットアドレス)。
lPitchINT4+40+20サーフェスの1走査線あたりのバイト数(ピッチ)を示す。負値も取り得る。
dwOverlayOffsetDWORD4+44+24オーバーレイデータのビデオメモリ先頭からのオフセットをバイト単位で示す。
dwOverlaySrcWidthDWORD4+48+28オーバーレイ転送元の幅をピクセル単位で示す。
dwOverlaySrcHeightDWORD4+52+32オーバーレイ転送元の高さをピクセル単位で示す。
dwOverlayDestWidthDWORD4+56+36オーバーレイ転送先の幅をピクセル単位で示す。
dwOverlayDestHeightDWORD4+60+40オーバーレイ転送先の高さをピクセル単位で示す。
dwDriverReserved1UINT_PTR8/4+64+44ドライバが任意に使用できる予約フィールド1。
dwDriverReserved2UINT_PTR8/4+72+48ドライバが任意に使用できる予約フィールド2。
dwDriverReserved3UINT_PTR8/4+80+52ドライバが任意に使用できる予約フィールド3。
ddRValHRESULT4+88+56操作の結果を示すHRESULT。成功時はDD_OK。

各言語での定義

#include <windows.h>

// DDHAL_SYNCSURFACEDATA  (x64 96 / x86 60 バイト)
typedef struct DDHAL_SYNCSURFACEDATA {
    DWORD dwSize;
    DDRAWI_DIRECTDRAW_LCL* lpDD;
    DDRAWI_DDRAWSURFACE_LCL* lpDDSurface;
    DWORD dwSurfaceOffset;
    UINT_PTR fpLockPtr;
    INT lPitch;
    DWORD dwOverlayOffset;
    DWORD dwOverlaySrcWidth;
    DWORD dwOverlaySrcHeight;
    DWORD dwOverlayDestWidth;
    DWORD dwOverlayDestHeight;
    UINT_PTR dwDriverReserved1;
    UINT_PTR dwDriverReserved2;
    UINT_PTR dwDriverReserved3;
    HRESULT ddRVal;
} DDHAL_SYNCSURFACEDATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDHAL_SYNCSURFACEDATA
{
    public uint dwSize;
    public IntPtr lpDD;
    public IntPtr lpDDSurface;
    public uint dwSurfaceOffset;
    public UIntPtr fpLockPtr;
    public int lPitch;
    public uint dwOverlayOffset;
    public uint dwOverlaySrcWidth;
    public uint dwOverlaySrcHeight;
    public uint dwOverlayDestWidth;
    public uint dwOverlayDestHeight;
    public UIntPtr dwDriverReserved1;
    public UIntPtr dwDriverReserved2;
    public UIntPtr dwDriverReserved3;
    public int ddRVal;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDHAL_SYNCSURFACEDATA
    Public dwSize As UInteger
    Public lpDD As IntPtr
    Public lpDDSurface As IntPtr
    Public dwSurfaceOffset As UInteger
    Public fpLockPtr As UIntPtr
    Public lPitch As Integer
    Public dwOverlayOffset As UInteger
    Public dwOverlaySrcWidth As UInteger
    Public dwOverlaySrcHeight As UInteger
    Public dwOverlayDestWidth As UInteger
    Public dwOverlayDestHeight As UInteger
    Public dwDriverReserved1 As UIntPtr
    Public dwDriverReserved2 As UIntPtr
    Public dwDriverReserved3 As UIntPtr
    Public ddRVal As Integer
End Structure
import ctypes
from ctypes import wintypes

class DDHAL_SYNCSURFACEDATA(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("lpDD", ctypes.c_void_p),
        ("lpDDSurface", ctypes.c_void_p),
        ("dwSurfaceOffset", wintypes.DWORD),
        ("fpLockPtr", ctypes.c_size_t),
        ("lPitch", ctypes.c_int),
        ("dwOverlayOffset", wintypes.DWORD),
        ("dwOverlaySrcWidth", wintypes.DWORD),
        ("dwOverlaySrcHeight", wintypes.DWORD),
        ("dwOverlayDestWidth", wintypes.DWORD),
        ("dwOverlayDestHeight", wintypes.DWORD),
        ("dwDriverReserved1", ctypes.c_size_t),
        ("dwDriverReserved2", ctypes.c_size_t),
        ("dwDriverReserved3", ctypes.c_size_t),
        ("ddRVal", ctypes.c_int),
    ]
#[repr(C)]
pub struct DDHAL_SYNCSURFACEDATA {
    pub dwSize: u32,
    pub lpDD: *mut core::ffi::c_void,
    pub lpDDSurface: *mut core::ffi::c_void,
    pub dwSurfaceOffset: u32,
    pub fpLockPtr: usize,
    pub lPitch: i32,
    pub dwOverlayOffset: u32,
    pub dwOverlaySrcWidth: u32,
    pub dwOverlaySrcHeight: u32,
    pub dwOverlayDestWidth: u32,
    pub dwOverlayDestHeight: u32,
    pub dwDriverReserved1: usize,
    pub dwDriverReserved2: usize,
    pub dwDriverReserved3: usize,
    pub ddRVal: i32,
}
import "golang.org/x/sys/windows"

type DDHAL_SYNCSURFACEDATA struct {
	dwSize uint32
	lpDD uintptr
	lpDDSurface uintptr
	dwSurfaceOffset uint32
	fpLockPtr uintptr
	lPitch int32
	dwOverlayOffset uint32
	dwOverlaySrcWidth uint32
	dwOverlaySrcHeight uint32
	dwOverlayDestWidth uint32
	dwOverlayDestHeight uint32
	dwDriverReserved1 uintptr
	dwDriverReserved2 uintptr
	dwDriverReserved3 uintptr
	ddRVal int32
}
type
  DDHAL_SYNCSURFACEDATA = record
    dwSize: DWORD;
    lpDD: Pointer;
    lpDDSurface: Pointer;
    dwSurfaceOffset: DWORD;
    fpLockPtr: NativeUInt;
    lPitch: Integer;
    dwOverlayOffset: DWORD;
    dwOverlaySrcWidth: DWORD;
    dwOverlaySrcHeight: DWORD;
    dwOverlayDestWidth: DWORD;
    dwOverlayDestHeight: DWORD;
    dwDriverReserved1: NativeUInt;
    dwDriverReserved2: NativeUInt;
    dwDriverReserved3: NativeUInt;
    ddRVal: Integer;
  end;
const DDHAL_SYNCSURFACEDATA = extern struct {
    dwSize: u32,
    lpDD: ?*anyopaque,
    lpDDSurface: ?*anyopaque,
    dwSurfaceOffset: u32,
    fpLockPtr: usize,
    lPitch: i32,
    dwOverlayOffset: u32,
    dwOverlaySrcWidth: u32,
    dwOverlaySrcHeight: u32,
    dwOverlayDestWidth: u32,
    dwOverlayDestHeight: u32,
    dwDriverReserved1: usize,
    dwDriverReserved2: usize,
    dwDriverReserved3: usize,
    ddRVal: i32,
};
type
  DDHAL_SYNCSURFACEDATA {.bycopy.} = object
    dwSize: uint32
    lpDD: pointer
    lpDDSurface: pointer
    dwSurfaceOffset: uint32
    fpLockPtr: uint
    lPitch: int32
    dwOverlayOffset: uint32
    dwOverlaySrcWidth: uint32
    dwOverlaySrcHeight: uint32
    dwOverlayDestWidth: uint32
    dwOverlayDestHeight: uint32
    dwDriverReserved1: uint
    dwDriverReserved2: uint
    dwDriverReserved3: uint
    ddRVal: int32
struct DDHAL_SYNCSURFACEDATA
{
    uint dwSize;
    void* lpDD;
    void* lpDDSurface;
    uint dwSurfaceOffset;
    size_t fpLockPtr;
    int lPitch;
    uint dwOverlayOffset;
    uint dwOverlaySrcWidth;
    uint dwOverlaySrcHeight;
    uint dwOverlayDestWidth;
    uint dwOverlayDestHeight;
    size_t dwDriverReserved1;
    size_t dwDriverReserved2;
    size_t dwDriverReserved3;
    int ddRVal;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DDHAL_SYNCSURFACEDATA サイズ: 60 バイト(x86)
dim st, 15    ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; lpDD : DDRAWI_DIRECTDRAW_LCL* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; lpDDSurface : DDRAWI_DDRAWSURFACE_LCL* (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; dwSurfaceOffset : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; fpLockPtr : UINT_PTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lPitch : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwOverlayOffset : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwOverlaySrcWidth : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwOverlaySrcHeight : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwOverlayDestWidth : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwOverlayDestHeight : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwDriverReserved1 : UINT_PTR (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwDriverReserved2 : UINT_PTR (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwDriverReserved3 : UINT_PTR (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ddRVal : HRESULT (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DDHAL_SYNCSURFACEDATA サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; lpDD : DDRAWI_DIRECTDRAW_LCL* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; lpDDSurface : DDRAWI_DDRAWSURFACE_LCL* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; dwSurfaceOffset : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; fpLockPtr : UINT_PTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lPitch : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwOverlayOffset : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwOverlaySrcWidth : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwOverlaySrcHeight : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; dwOverlayDestWidth : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; dwOverlayDestHeight : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; dwDriverReserved1 : UINT_PTR (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; dwDriverReserved2 : UINT_PTR (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; dwDriverReserved3 : UINT_PTR (+80, 8byte)  qpoke st,80,値 / qpeek(st,80)  ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; ddRVal : HRESULT (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DDHAL_SYNCSURFACEDATA
    #field int dwSize
    #field intptr lpDD
    #field intptr lpDDSurface
    #field int dwSurfaceOffset
    #field intptr fpLockPtr
    #field int lPitch
    #field int dwOverlayOffset
    #field int dwOverlaySrcWidth
    #field int dwOverlaySrcHeight
    #field int dwOverlayDestWidth
    #field int dwOverlayDestHeight
    #field intptr dwDriverReserved1
    #field intptr dwDriverReserved2
    #field intptr dwDriverReserved3
    #field int ddRVal
#endstruct

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