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

DD_SYNCSURFACEDATA

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

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

フィールド

フィールド型サイズx64x86説明
lpDDDD_DIRECTDRAW_LOCAL*8/4+0+0対象のDirectDrawローカルオブジェクトへのポインタ。
lpDDSurfaceDD_SURFACE_LOCAL*8/4+8+4同期対象サーフェスのローカルオブジェクトへのポインタ。
dwSurfaceOffsetDWORD4+16+8ビデオメモリ先頭からのサーフェスデータのオフセットをバイト単位で示す。
fpLockPtrUINT_PTR8/4+24+12ロックされたサーフェスメモリへのフラットアドレス。
lPitchINT4+32+16サーフェスの1走査線あたりのバイト数(ピッチ)。
dwOverlayOffsetDWORD4+36+20オーバーレイデータのオフセットをバイト単位で示す。
dwDriverReserved1DWORD4+40+24ドライバが任意に使用できる予約フィールド1。
dwDriverReserved2DWORD4+44+28ドライバが任意に使用できる予約フィールド2。
dwDriverReserved3DWORD4+48+32ドライバが任意に使用できる予約フィールド3。
dwDriverReserved4DWORD4+52+36ドライバが任意に使用できる予約フィールド4。
ddRValHRESULT4+56+40操作の結果を示すHRESULT。成功時はDD_OK。

各言語での定義

#include <windows.h>

// DD_SYNCSURFACEDATA  (x64 64 / x86 44 バイト)
typedef struct DD_SYNCSURFACEDATA {
    DD_DIRECTDRAW_LOCAL* lpDD;
    DD_SURFACE_LOCAL* lpDDSurface;
    DWORD dwSurfaceOffset;
    UINT_PTR fpLockPtr;
    INT lPitch;
    DWORD dwOverlayOffset;
    DWORD dwDriverReserved1;
    DWORD dwDriverReserved2;
    DWORD dwDriverReserved3;
    DWORD dwDriverReserved4;
    HRESULT ddRVal;
} DD_SYNCSURFACEDATA;
using System;
using System.Runtime.InteropServices;

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

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_SYNCSURFACEDATA
    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 dwDriverReserved1 As UInteger
    Public dwDriverReserved2 As UInteger
    Public dwDriverReserved3 As UInteger
    Public dwDriverReserved4 As UInteger
    Public ddRVal As Integer
End Structure
import ctypes
from ctypes import wintypes

class DD_SYNCSURFACEDATA(ctypes.Structure):
    _fields_ = [
        ("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),
        ("dwDriverReserved1", wintypes.DWORD),
        ("dwDriverReserved2", wintypes.DWORD),
        ("dwDriverReserved3", wintypes.DWORD),
        ("dwDriverReserved4", wintypes.DWORD),
        ("ddRVal", ctypes.c_int),
    ]
#[repr(C)]
pub struct DD_SYNCSURFACEDATA {
    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 dwDriverReserved1: u32,
    pub dwDriverReserved2: u32,
    pub dwDriverReserved3: u32,
    pub dwDriverReserved4: u32,
    pub ddRVal: i32,
}
import "golang.org/x/sys/windows"

type DD_SYNCSURFACEDATA struct {
	lpDD uintptr
	lpDDSurface uintptr
	dwSurfaceOffset uint32
	fpLockPtr uintptr
	lPitch int32
	dwOverlayOffset uint32
	dwDriverReserved1 uint32
	dwDriverReserved2 uint32
	dwDriverReserved3 uint32
	dwDriverReserved4 uint32
	ddRVal int32
}
type
  DD_SYNCSURFACEDATA = record
    lpDD: Pointer;
    lpDDSurface: Pointer;
    dwSurfaceOffset: DWORD;
    fpLockPtr: NativeUInt;
    lPitch: Integer;
    dwOverlayOffset: DWORD;
    dwDriverReserved1: DWORD;
    dwDriverReserved2: DWORD;
    dwDriverReserved3: DWORD;
    dwDriverReserved4: DWORD;
    ddRVal: Integer;
  end;
const DD_SYNCSURFACEDATA = extern struct {
    lpDD: ?*anyopaque,
    lpDDSurface: ?*anyopaque,
    dwSurfaceOffset: u32,
    fpLockPtr: usize,
    lPitch: i32,
    dwOverlayOffset: u32,
    dwDriverReserved1: u32,
    dwDriverReserved2: u32,
    dwDriverReserved3: u32,
    dwDriverReserved4: u32,
    ddRVal: i32,
};
type
  DD_SYNCSURFACEDATA {.bycopy.} = object
    lpDD: pointer
    lpDDSurface: pointer
    dwSurfaceOffset: uint32
    fpLockPtr: uint
    lPitch: int32
    dwOverlayOffset: uint32
    dwDriverReserved1: uint32
    dwDriverReserved2: uint32
    dwDriverReserved3: uint32
    dwDriverReserved4: uint32
    ddRVal: int32
struct DD_SYNCSURFACEDATA
{
    void* lpDD;
    void* lpDDSurface;
    uint dwSurfaceOffset;
    size_t fpLockPtr;
    int lPitch;
    uint dwOverlayOffset;
    uint dwDriverReserved1;
    uint dwDriverReserved2;
    uint dwDriverReserved3;
    uint dwDriverReserved4;
    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 レイアウト)
; DD_SYNCSURFACEDATA サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_LOCAL* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; lpDDSurface : DD_SURFACE_LOCAL* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; dwSurfaceOffset : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; fpLockPtr : UINT_PTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lPitch : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwOverlayOffset : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwDriverReserved1 : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwDriverReserved2 : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwDriverReserved3 : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwDriverReserved4 : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ddRVal : HRESULT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_SYNCSURFACEDATA サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_LOCAL* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; lpDDSurface : DD_SURFACE_LOCAL* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; dwSurfaceOffset : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; fpLockPtr : UINT_PTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lPitch : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwOverlayOffset : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwDriverReserved1 : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwDriverReserved2 : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwDriverReserved3 : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwDriverReserved4 : DWORD (+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 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DD_SYNCSURFACEDATA
    #field intptr lpDD
    #field intptr lpDDSurface
    #field int dwSurfaceOffset
    #field intptr fpLockPtr
    #field int lPitch
    #field int dwOverlayOffset
    #field int dwDriverReserved1
    #field int dwDriverReserved2
    #field int dwDriverReserved3
    #field int dwDriverReserved4
    #field int ddRVal
#endstruct

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