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

DDSURFACEDATA

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

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

フィールド

フィールドサイズx64x86説明
ddsCapsDWORD4+0+0サーフェスの能力を示すフラグ。
dwSurfaceOffsetDWORD4+4+4ビデオメモリ先頭からのサーフェスデータのオフセットをバイト単位で示す。
fpLockPtrUINT_PTR8/4+8+8ロックされたサーフェスメモリへのフラットアドレス。
dwWidthDWORD4+16+12サーフェスの幅をピクセル単位で示す。
dwHeightDWORD4+20+16サーフェスの高さをピクセル単位で示す。
lPitchINT4+24+201走査線あたりのバイト数(ピッチ)。
dwOverlayFlagsDWORD4+28+24オーバーレイ動作を制御するフラグ。
dwOverlayOffsetDWORD4+32+28オーバーレイデータのオフセットをバイト単位で示す。
dwOverlaySrcWidthDWORD4+36+32オーバーレイ転送元の幅をピクセル単位で示す。
dwOverlaySrcHeightDWORD4+40+36オーバーレイ転送元の高さをピクセル単位で示す。
dwOverlayDestWidthDWORD4+44+40オーバーレイ転送先の幅をピクセル単位で示す。
dwOverlayDestHeightDWORD4+48+44オーバーレイ転送先の高さをピクセル単位で示す。
dwVideoPortIdDWORD4+52+48関連するビデオポートのID。
dwFormatFlagsDWORD4+56+52ピクセル形式の種別を示すフラグ。
dwFormatFourCCDWORD4+60+56FourCC形式の場合のコード値。
dwFormatBitCountDWORD4+64+601ピクセルあたりのビット数。
dwRBitMaskDWORD4+68+64赤成分のビットマスク。
dwGBitMaskDWORD4+72+68緑成分のビットマスク。
dwBBitMaskDWORD4+76+72青成分のビットマスク。
dwDriverReserved1DWORD4+80+76ドライバが任意に使用できる予約フィールド1。
dwDriverReserved2DWORD4+84+80ドライバが任意に使用できる予約フィールド2。
dwDriverReserved3DWORD4+88+84ドライバが任意に使用できる予約フィールド3。
dwDriverReserved4DWORD4+92+88ドライバが任意に使用できる予約フィールド4。

各言語での定義

#include <windows.h>

// DDSURFACEDATA  (x64 96 / x86 92 バイト)
typedef struct DDSURFACEDATA {
    DWORD ddsCaps;
    DWORD dwSurfaceOffset;
    UINT_PTR fpLockPtr;
    DWORD dwWidth;
    DWORD dwHeight;
    INT lPitch;
    DWORD dwOverlayFlags;
    DWORD dwOverlayOffset;
    DWORD dwOverlaySrcWidth;
    DWORD dwOverlaySrcHeight;
    DWORD dwOverlayDestWidth;
    DWORD dwOverlayDestHeight;
    DWORD dwVideoPortId;
    DWORD dwFormatFlags;
    DWORD dwFormatFourCC;
    DWORD dwFormatBitCount;
    DWORD dwRBitMask;
    DWORD dwGBitMask;
    DWORD dwBBitMask;
    DWORD dwDriverReserved1;
    DWORD dwDriverReserved2;
    DWORD dwDriverReserved3;
    DWORD dwDriverReserved4;
} DDSURFACEDATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDSURFACEDATA
{
    public uint ddsCaps;
    public uint dwSurfaceOffset;
    public UIntPtr fpLockPtr;
    public uint dwWidth;
    public uint dwHeight;
    public int lPitch;
    public uint dwOverlayFlags;
    public uint dwOverlayOffset;
    public uint dwOverlaySrcWidth;
    public uint dwOverlaySrcHeight;
    public uint dwOverlayDestWidth;
    public uint dwOverlayDestHeight;
    public uint dwVideoPortId;
    public uint dwFormatFlags;
    public uint dwFormatFourCC;
    public uint dwFormatBitCount;
    public uint dwRBitMask;
    public uint dwGBitMask;
    public uint dwBBitMask;
    public uint dwDriverReserved1;
    public uint dwDriverReserved2;
    public uint dwDriverReserved3;
    public uint dwDriverReserved4;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDSURFACEDATA
    Public ddsCaps As UInteger
    Public dwSurfaceOffset As UInteger
    Public fpLockPtr As UIntPtr
    Public dwWidth As UInteger
    Public dwHeight As UInteger
    Public lPitch As Integer
    Public dwOverlayFlags As UInteger
    Public dwOverlayOffset As UInteger
    Public dwOverlaySrcWidth As UInteger
    Public dwOverlaySrcHeight As UInteger
    Public dwOverlayDestWidth As UInteger
    Public dwOverlayDestHeight As UInteger
    Public dwVideoPortId As UInteger
    Public dwFormatFlags As UInteger
    Public dwFormatFourCC As UInteger
    Public dwFormatBitCount As UInteger
    Public dwRBitMask As UInteger
    Public dwGBitMask As UInteger
    Public dwBBitMask As UInteger
    Public dwDriverReserved1 As UInteger
    Public dwDriverReserved2 As UInteger
    Public dwDriverReserved3 As UInteger
    Public dwDriverReserved4 As UInteger
End Structure
import ctypes
from ctypes import wintypes

class DDSURFACEDATA(ctypes.Structure):
    _fields_ = [
        ("ddsCaps", wintypes.DWORD),
        ("dwSurfaceOffset", wintypes.DWORD),
        ("fpLockPtr", ctypes.c_size_t),
        ("dwWidth", wintypes.DWORD),
        ("dwHeight", wintypes.DWORD),
        ("lPitch", ctypes.c_int),
        ("dwOverlayFlags", wintypes.DWORD),
        ("dwOverlayOffset", wintypes.DWORD),
        ("dwOverlaySrcWidth", wintypes.DWORD),
        ("dwOverlaySrcHeight", wintypes.DWORD),
        ("dwOverlayDestWidth", wintypes.DWORD),
        ("dwOverlayDestHeight", wintypes.DWORD),
        ("dwVideoPortId", wintypes.DWORD),
        ("dwFormatFlags", wintypes.DWORD),
        ("dwFormatFourCC", wintypes.DWORD),
        ("dwFormatBitCount", wintypes.DWORD),
        ("dwRBitMask", wintypes.DWORD),
        ("dwGBitMask", wintypes.DWORD),
        ("dwBBitMask", wintypes.DWORD),
        ("dwDriverReserved1", wintypes.DWORD),
        ("dwDriverReserved2", wintypes.DWORD),
        ("dwDriverReserved3", wintypes.DWORD),
        ("dwDriverReserved4", wintypes.DWORD),
    ]
#[repr(C)]
pub struct DDSURFACEDATA {
    pub ddsCaps: u32,
    pub dwSurfaceOffset: u32,
    pub fpLockPtr: usize,
    pub dwWidth: u32,
    pub dwHeight: u32,
    pub lPitch: i32,
    pub dwOverlayFlags: u32,
    pub dwOverlayOffset: u32,
    pub dwOverlaySrcWidth: u32,
    pub dwOverlaySrcHeight: u32,
    pub dwOverlayDestWidth: u32,
    pub dwOverlayDestHeight: u32,
    pub dwVideoPortId: u32,
    pub dwFormatFlags: u32,
    pub dwFormatFourCC: u32,
    pub dwFormatBitCount: u32,
    pub dwRBitMask: u32,
    pub dwGBitMask: u32,
    pub dwBBitMask: u32,
    pub dwDriverReserved1: u32,
    pub dwDriverReserved2: u32,
    pub dwDriverReserved3: u32,
    pub dwDriverReserved4: u32,
}
import "golang.org/x/sys/windows"

type DDSURFACEDATA struct {
	ddsCaps uint32
	dwSurfaceOffset uint32
	fpLockPtr uintptr
	dwWidth uint32
	dwHeight uint32
	lPitch int32
	dwOverlayFlags uint32
	dwOverlayOffset uint32
	dwOverlaySrcWidth uint32
	dwOverlaySrcHeight uint32
	dwOverlayDestWidth uint32
	dwOverlayDestHeight uint32
	dwVideoPortId uint32
	dwFormatFlags uint32
	dwFormatFourCC uint32
	dwFormatBitCount uint32
	dwRBitMask uint32
	dwGBitMask uint32
	dwBBitMask uint32
	dwDriverReserved1 uint32
	dwDriverReserved2 uint32
	dwDriverReserved3 uint32
	dwDriverReserved4 uint32
}
type
  DDSURFACEDATA = record
    ddsCaps: DWORD;
    dwSurfaceOffset: DWORD;
    fpLockPtr: NativeUInt;
    dwWidth: DWORD;
    dwHeight: DWORD;
    lPitch: Integer;
    dwOverlayFlags: DWORD;
    dwOverlayOffset: DWORD;
    dwOverlaySrcWidth: DWORD;
    dwOverlaySrcHeight: DWORD;
    dwOverlayDestWidth: DWORD;
    dwOverlayDestHeight: DWORD;
    dwVideoPortId: DWORD;
    dwFormatFlags: DWORD;
    dwFormatFourCC: DWORD;
    dwFormatBitCount: DWORD;
    dwRBitMask: DWORD;
    dwGBitMask: DWORD;
    dwBBitMask: DWORD;
    dwDriverReserved1: DWORD;
    dwDriverReserved2: DWORD;
    dwDriverReserved3: DWORD;
    dwDriverReserved4: DWORD;
  end;
const DDSURFACEDATA = extern struct {
    ddsCaps: u32,
    dwSurfaceOffset: u32,
    fpLockPtr: usize,
    dwWidth: u32,
    dwHeight: u32,
    lPitch: i32,
    dwOverlayFlags: u32,
    dwOverlayOffset: u32,
    dwOverlaySrcWidth: u32,
    dwOverlaySrcHeight: u32,
    dwOverlayDestWidth: u32,
    dwOverlayDestHeight: u32,
    dwVideoPortId: u32,
    dwFormatFlags: u32,
    dwFormatFourCC: u32,
    dwFormatBitCount: u32,
    dwRBitMask: u32,
    dwGBitMask: u32,
    dwBBitMask: u32,
    dwDriverReserved1: u32,
    dwDriverReserved2: u32,
    dwDriverReserved3: u32,
    dwDriverReserved4: u32,
};
type
  DDSURFACEDATA {.bycopy.} = object
    ddsCaps: uint32
    dwSurfaceOffset: uint32
    fpLockPtr: uint
    dwWidth: uint32
    dwHeight: uint32
    lPitch: int32
    dwOverlayFlags: uint32
    dwOverlayOffset: uint32
    dwOverlaySrcWidth: uint32
    dwOverlaySrcHeight: uint32
    dwOverlayDestWidth: uint32
    dwOverlayDestHeight: uint32
    dwVideoPortId: uint32
    dwFormatFlags: uint32
    dwFormatFourCC: uint32
    dwFormatBitCount: uint32
    dwRBitMask: uint32
    dwGBitMask: uint32
    dwBBitMask: uint32
    dwDriverReserved1: uint32
    dwDriverReserved2: uint32
    dwDriverReserved3: uint32
    dwDriverReserved4: uint32
struct DDSURFACEDATA
{
    uint ddsCaps;
    uint dwSurfaceOffset;
    size_t fpLockPtr;
    uint dwWidth;
    uint dwHeight;
    int lPitch;
    uint dwOverlayFlags;
    uint dwOverlayOffset;
    uint dwOverlaySrcWidth;
    uint dwOverlaySrcHeight;
    uint dwOverlayDestWidth;
    uint dwOverlayDestHeight;
    uint dwVideoPortId;
    uint dwFormatFlags;
    uint dwFormatFourCC;
    uint dwFormatBitCount;
    uint dwRBitMask;
    uint dwGBitMask;
    uint dwBBitMask;
    uint dwDriverReserved1;
    uint dwDriverReserved2;
    uint dwDriverReserved3;
    uint dwDriverReserved4;
}

HSP用 定義

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

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

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