ホーム › Graphics.DirectDraw › DD_CREATESURFACEDATA
DD_CREATESURFACEDATA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| lpDD | DD_DIRECTDRAW_GLOBAL* | 8/4 | +0 | +0 | ドライバーのデバイスを記述する DD_DIRECTDRAW_GLOBAL 構造体へのポインターです。 |
| lpDDSurfaceDesc | DDSURFACEDESC* | 8/4 | +8 | +4 | ドライバーが作成するサーフェスまたはバッファーを記述する DDSURFACEDESC 構造体へのポインターです。 |
| lplpSList | DD_SURFACE_LOCAL** | 8/4 | +16 | +8 | ドライバーが作成したサーフェスオブジェクトを記述する DD_SURFACE_LOCAL 構造体のリストへのポインターです。Microsoft Windows 2000 以降では、通常この配列のエントリは 1 つだけです。ただし、ドライバーが GUID_NTPrivateDriverCaps を指定した DdGetDriverInfo による Windows 98/Me 形式のサーフェス作成手法をサポートし、かつ DDHAL_PRIVATECAP_ATOMICSURFACECREATION フラグを設定している場合、このメンバーには (通常は複数の) サーフェスのリストが格納されます。 |
| dwSCnt | DWORD | 4 | +24 | +12 | lplpSList が指すリスト内のサーフェスの数を指定します。Windows 2000 以降では、この値は通常 1 です。ただし、ドライバーが GUID_NTPrivateDriverCaps を指定した DdGetDriverInfo による Windows 98/Me 形式のサーフェス作成手法をサポートしている場合、このメンバーにはリスト内の実際のサーフェス数 (通常は複数) が格納されます。 |
| ddRVal | HRESULT | 4 | +28 | +16 | DdCreateSurface コールバックまたは CreateD3DBuffer コールバックの戻り値をドライバーが書き込む場所を指定します。戻り値 DD_OK は成功を示します。詳細については、Return Values for DirectDraw を参照してください。 |
| CreateSurface | void* | 8/4 | +32 | +20 | Microsoft DirectDraw API によって使用されるため、ドライバーが設定してはなりません。 |
公式ドキュメント
DD_CREATESURFACEDATA 構造体は、サーフェスを作成する (CreateD3DBuffer の場合はコマンドバッファーまたは頂点バッファーを作成する) ために必要な情報を格納します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
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 Structureimport 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: pointerstruct 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