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

DD_CREATESURFACEDATA

構造体
サイズx64: 40 バイト / x86: 24 バイト

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

フィールド

フィールドサイズx64x86説明
lpDDDD_DIRECTDRAW_GLOBAL*8/4+0+0ドライバーのデバイスを記述する DD_DIRECTDRAW_GLOBAL 構造体へのポインターです。
lpDDSurfaceDescDDSURFACEDESC*8/4+8+4ドライバーが作成するサーフェスまたはバッファーを記述する DDSURFACEDESC 構造体へのポインターです。
lplpSListDD_SURFACE_LOCAL**8/4+16+8ドライバーが作成したサーフェスオブジェクトを記述する DD_SURFACE_LOCAL 構造体のリストへのポインターです。Microsoft Windows 2000 以降では、通常この配列のエントリは 1 つだけです。ただし、ドライバーが GUID_NTPrivateDriverCaps を指定した DdGetDriverInfo による Windows 98/Me 形式のサーフェス作成手法をサポートし、かつ DDHAL_PRIVATECAP_ATOMICSURFACECREATION フラグを設定している場合、このメンバーには (通常は複数の) サーフェスのリストが格納されます。
dwSCntDWORD4+24+12lplpSList が指すリスト内のサーフェスの数を指定します。Windows 2000 以降では、この値は通常 1 です。ただし、ドライバーが GUID_NTPrivateDriverCaps を指定した DdGetDriverInfo による Windows 98/Me 形式のサーフェス作成手法をサポートしている場合、このメンバーにはリスト内の実際のサーフェス数 (通常は複数) が格納されます。
ddRValHRESULT4+28+16DdCreateSurface コールバックまたは CreateD3DBuffer コールバックの戻り値をドライバーが書き込む場所を指定します。戻り値 DD_OK は成功を示します。詳細については、Return Values for DirectDraw を参照してください。
CreateSurfacevoid*8/4+32+20Microsoft DirectDraw API によって使用されるため、ドライバーが設定してはなりません。

公式ドキュメント

DD_CREATESURFACEDATA 構造体は、サーフェスを作成する (CreateD3DBuffer の場合はコマンドバッファーまたは頂点バッファーを作成する) ために必要な情報を格納します。

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

各言語での定義

#include <windows.h>

// DD_CREATESURFACEDATA  (x64 40 / x86 24 バイト)
typedef struct DD_CREATESURFACEDATA {
    DD_DIRECTDRAW_GLOBAL* lpDD;
    DDSURFACEDESC* lpDDSurfaceDesc;
    DD_SURFACE_LOCAL** lplpSList;
    DWORD dwSCnt;
    HRESULT ddRVal;
    void* CreateSurface;
} DD_CREATESURFACEDATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_CREATESURFACEDATA
{
    public IntPtr lpDD;
    public IntPtr lpDDSurfaceDesc;
    public IntPtr lplpSList;
    public uint dwSCnt;
    public int ddRVal;
    public IntPtr CreateSurface;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_CREATESURFACEDATA
    Public lpDD As IntPtr
    Public lpDDSurfaceDesc As IntPtr
    Public lplpSList As IntPtr
    Public dwSCnt As UInteger
    Public ddRVal As Integer
    Public CreateSurface As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DD_CREATESURFACEDATA(ctypes.Structure):
    _fields_ = [
        ("lpDD", ctypes.c_void_p),
        ("lpDDSurfaceDesc", ctypes.c_void_p),
        ("lplpSList", ctypes.c_void_p),
        ("dwSCnt", wintypes.DWORD),
        ("ddRVal", ctypes.c_int),
        ("CreateSurface", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DD_CREATESURFACEDATA {
    pub lpDD: *mut core::ffi::c_void,
    pub lpDDSurfaceDesc: *mut core::ffi::c_void,
    pub lplpSList: *mut core::ffi::c_void,
    pub dwSCnt: u32,
    pub ddRVal: i32,
    pub CreateSurface: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DD_CREATESURFACEDATA struct {
	lpDD uintptr
	lpDDSurfaceDesc uintptr
	lplpSList uintptr
	dwSCnt uint32
	ddRVal int32
	CreateSurface uintptr
}
type
  DD_CREATESURFACEDATA = record
    lpDD: Pointer;
    lpDDSurfaceDesc: Pointer;
    lplpSList: Pointer;
    dwSCnt: DWORD;
    ddRVal: Integer;
    CreateSurface: Pointer;
  end;
const DD_CREATESURFACEDATA = extern struct {
    lpDD: ?*anyopaque,
    lpDDSurfaceDesc: ?*anyopaque,
    lplpSList: ?*anyopaque,
    dwSCnt: u32,
    ddRVal: i32,
    CreateSurface: ?*anyopaque,
};
type
  DD_CREATESURFACEDATA {.bycopy.} = object
    lpDD: pointer
    lpDDSurfaceDesc: pointer
    lplpSList: pointer
    dwSCnt: uint32
    ddRVal: int32
    CreateSurface: pointer
struct DD_CREATESURFACEDATA
{
    void* lpDD;
    void* lpDDSurfaceDesc;
    void* lplpSList;
    uint dwSCnt;
    int ddRVal;
    void* CreateSurface;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_CREATESURFACEDATA サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_GLOBAL* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; lpDDSurfaceDesc : DDSURFACEDESC* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; lplpSList : DD_SURFACE_LOCAL** (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; dwSCnt : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ddRVal : HRESULT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; CreateSurface : void* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_CREATESURFACEDATA サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_GLOBAL* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; lpDDSurfaceDesc : DDSURFACEDESC* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; lplpSList : DD_SURFACE_LOCAL** (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; dwSCnt : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ddRVal : HRESULT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; CreateSurface : void* (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DD_CREATESURFACEDATA
    #field intptr lpDD
    #field intptr lpDDSurfaceDesc
    #field intptr lplpSList
    #field int dwSCnt
    #field int ddRVal
    #field intptr CreateSurface
#endstruct

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