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

DD_CANCREATESURFACEDATA

構造体
サイズx64: 32 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(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 構造体を指します。このメンバーに関する追加情報については、「解説」セクションを参照してください。
bIsDifferentPixelFormatDWORD4+16+8作成するサーフェスのピクセル形式が、プライマリサーフェスのピクセル形式と異なるかどうかを示します。CanCreateD3DBuffer D3DBuffer コールバックの場合、ドライバーはピクセルデータではなく頂点データまたはコマンドを格納するバッファーの作成を試みているため、このメンバーは常に FALSE に設定されます。
ddRValHRESULT4+20+12DdCanCreateSurface または CanCreateD3DBuffer コールバックの戻り値をドライバーが書き込む場所を指定します。DD_OK の戻りコードは成功を示します。詳細については、「Return Values for DirectDraw」を参照してください。
CanCreateSurfacevoid*8/4+24+16Microsoft DirectDraw API によって使用されるため、ドライバーが設定してはなりません。

公式ドキュメント

DD_CANCREATESURFACEDATA 構造体は、サーフェス (CanCreateD3DBuffer の場合はバッファー) を作成できるかどうかを示すために必要な情報を格納します。

解説(Remarks)

lpDDSurfaceDesc メンバーが指す DirectDraw サーフェス記述は、DirectDraw 6.0 以降のランタイムでは実際には (DDSURFACEDESC 構造体ではなく) DDSURFACEDESC2 構造体です。したがって、DDSURFACEDESC2 構造体には存在するが DDSURFACEDESC 構造体には存在しないメンバーの情報がサーフェス作成時に必要な場合は、使用前に DDSURFACEDESC 構造体へのポインターを DDSURFACEDESC2 構造体へのポインターにキャストするだけで済みます。次の例は、DDSURFACEDESC 構造体へのポインターから dwTextureStage (DDSURFACEDESC2 構造体のメンバーですが、DDSURFACEDESC 構造体のメンバーではありません) の値を取得する方法を示しています。

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

各言語での定義

#include <windows.h>

// DD_CANCREATESURFACEDATA  (x64 32 / x86 20 バイト)
typedef struct DD_CANCREATESURFACEDATA {
    DD_DIRECTDRAW_GLOBAL* lpDD;
    DDSURFACEDESC* lpDDSurfaceDesc;
    DWORD bIsDifferentPixelFormat;
    HRESULT ddRVal;
    void* CanCreateSurface;
} DD_CANCREATESURFACEDATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_CANCREATESURFACEDATA
{
    public IntPtr lpDD;
    public IntPtr lpDDSurfaceDesc;
    public uint bIsDifferentPixelFormat;
    public int ddRVal;
    public IntPtr CanCreateSurface;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_CANCREATESURFACEDATA
    Public lpDD As IntPtr
    Public lpDDSurfaceDesc As IntPtr
    Public bIsDifferentPixelFormat As UInteger
    Public ddRVal As Integer
    Public CanCreateSurface As IntPtr
End Structure
import ctypes
from ctypes import wintypes

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

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

HSP用 定義

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

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

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