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

DD_D3DBUFCALLBACKS

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

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

フィールド

フィールド型サイズx64x86説明
dwSizeDWORD4+0+0この DD_D3DBUFCALLBACKS 構造体のサイズをバイト単位で指定します。
dwFlagsDWORD4+4+4予約済みです。
CanCreateD3DBufferPDD_CANCREATESURFACE8/4+8+8ドライバーの CanCreateD3DBuffer コールバックを指します。
CreateD3DBufferPDD_CREATESURFACE8/4+16+12ドライバーの CreateD3DBuffer コールバックを指します。
DestroyD3DBufferPDD_SURFCB_DESTROYSURFACE8/4+24+16ドライバーの DestroyD3DBuffer コールバックを指します。
LockD3DBufferPDD_SURFCB_LOCK8/4+32+20ドライバーの LockD3DBuffer コールバックを指します。
UnlockD3DBufferPDD_SURFCB_UNLOCK8/4+40+24ドライバーの UnlockD3DBuffer コールバックを指します。

公式ドキュメント

DD_D3DBUFCALLBACKS 構造体は、コマンドバッファーおよび頂点バッファーのドライバーレベルでの割り当てを実装するドライバーでのみ使用されます。

解説(Remarks)

独自のコマンドバッファーおよび頂点バッファーを管理するドライバーは、DD_D3DBUFCALLBACKS 構造体に値を設定し、DD_HALINFO の lpD3DBufCallbacks メンバーがそれを指すようにする必要があります。

また、ドライバーは DD_D3DBUFCALLBACKS 構造体で報告されるコールバック関数をサポートする必要があります。これらの XxxD3DBuffer コールバックは、いずれも同様の名前を持つ DdXxxSurface コールバックに対応しており、同じプロトタイプを持ち、同じ入力パラメーターで呼び出されます。これらの新しいコールバックは、対象のサーフェスのサーフェス caps に DDSCAPS_EXECUTEBUFFER フラグが設定されている場合にのみ呼び出されます。バッファーの作成フラグは DDSCAPS_WRITEONLY、DDSCAPS2_VERTEXBUFFER、および DDSCAPS2_COMMANDBUFFER です。

ドライバーは、CanCreateD3DBuffer および CreateD3DBuffer に渡される DD_SURFACE_LOCAL 構造体の ddsCaps メンバーで次のフラグを調べることにより、要求されているバッファーの種類を判別します。

暗黙的な頂点バッファーは読み取り/書き込みが想定されるため、ビデオメモリに配置しないでください。ビデオメモリに安全に配置できるのは、DDSCAPS_WRITEONLY フラグが設定された明示的な頂点バッファーのみです。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// DD_D3DBUFCALLBACKS  (x64 48 / x86 28 バイト)
typedef struct DD_D3DBUFCALLBACKS {
    DWORD dwSize;
    DWORD dwFlags;
    PDD_CANCREATESURFACE CanCreateD3DBuffer;
    PDD_CREATESURFACE CreateD3DBuffer;
    PDD_SURFCB_DESTROYSURFACE DestroyD3DBuffer;
    PDD_SURFCB_LOCK LockD3DBuffer;
    PDD_SURFCB_UNLOCK UnlockD3DBuffer;
} DD_D3DBUFCALLBACKS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_D3DBUFCALLBACKS
{
    public uint dwSize;
    public uint dwFlags;
    public IntPtr CanCreateD3DBuffer;
    public IntPtr CreateD3DBuffer;
    public IntPtr DestroyD3DBuffer;
    public IntPtr LockD3DBuffer;
    public IntPtr UnlockD3DBuffer;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_D3DBUFCALLBACKS
    Public dwSize As UInteger
    Public dwFlags As UInteger
    Public CanCreateD3DBuffer As IntPtr
    Public CreateD3DBuffer As IntPtr
    Public DestroyD3DBuffer As IntPtr
    Public LockD3DBuffer As IntPtr
    Public UnlockD3DBuffer As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DD_D3DBUFCALLBACKS(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("CanCreateD3DBuffer", ctypes.c_void_p),
        ("CreateD3DBuffer", ctypes.c_void_p),
        ("DestroyD3DBuffer", ctypes.c_void_p),
        ("LockD3DBuffer", ctypes.c_void_p),
        ("UnlockD3DBuffer", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DD_D3DBUFCALLBACKS {
    pub dwSize: u32,
    pub dwFlags: u32,
    pub CanCreateD3DBuffer: *mut core::ffi::c_void,
    pub CreateD3DBuffer: *mut core::ffi::c_void,
    pub DestroyD3DBuffer: *mut core::ffi::c_void,
    pub LockD3DBuffer: *mut core::ffi::c_void,
    pub UnlockD3DBuffer: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DD_D3DBUFCALLBACKS struct {
	dwSize uint32
	dwFlags uint32
	CanCreateD3DBuffer uintptr
	CreateD3DBuffer uintptr
	DestroyD3DBuffer uintptr
	LockD3DBuffer uintptr
	UnlockD3DBuffer uintptr
}
type
  DD_D3DBUFCALLBACKS = record
    dwSize: DWORD;
    dwFlags: DWORD;
    CanCreateD3DBuffer: Pointer;
    CreateD3DBuffer: Pointer;
    DestroyD3DBuffer: Pointer;
    LockD3DBuffer: Pointer;
    UnlockD3DBuffer: Pointer;
  end;
const DD_D3DBUFCALLBACKS = extern struct {
    dwSize: u32,
    dwFlags: u32,
    CanCreateD3DBuffer: ?*anyopaque,
    CreateD3DBuffer: ?*anyopaque,
    DestroyD3DBuffer: ?*anyopaque,
    LockD3DBuffer: ?*anyopaque,
    UnlockD3DBuffer: ?*anyopaque,
};
type
  DD_D3DBUFCALLBACKS {.bycopy.} = object
    dwSize: uint32
    dwFlags: uint32
    CanCreateD3DBuffer: pointer
    CreateD3DBuffer: pointer
    DestroyD3DBuffer: pointer
    LockD3DBuffer: pointer
    UnlockD3DBuffer: pointer
struct DD_D3DBUFCALLBACKS
{
    uint dwSize;
    uint dwFlags;
    void* CanCreateD3DBuffer;
    void* CreateD3DBuffer;
    void* DestroyD3DBuffer;
    void* LockD3DBuffer;
    void* UnlockD3DBuffer;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_D3DBUFCALLBACKS サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; CanCreateD3DBuffer : PDD_CANCREATESURFACE (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; CreateD3DBuffer : PDD_CREATESURFACE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; DestroyD3DBuffer : PDD_SURFCB_DESTROYSURFACE (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; LockD3DBuffer : PDD_SURFCB_LOCK (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; UnlockD3DBuffer : PDD_SURFCB_UNLOCK (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_D3DBUFCALLBACKS サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; CanCreateD3DBuffer : PDD_CANCREATESURFACE (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; CreateD3DBuffer : PDD_CREATESURFACE (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; DestroyD3DBuffer : PDD_SURFCB_DESTROYSURFACE (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; LockD3DBuffer : PDD_SURFCB_LOCK (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; UnlockD3DBuffer : PDD_SURFCB_UNLOCK (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DD_D3DBUFCALLBACKS
    #field int dwSize
    #field int dwFlags
    #field intptr CanCreateD3DBuffer
    #field intptr CreateD3DBuffer
    #field intptr DestroyD3DBuffer
    #field intptr LockD3DBuffer
    #field intptr UnlockD3DBuffer
#endstruct

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