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

DD_CALLBACKS

構造体
サイズx64: 80 バイト / x86: 44 バイト

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズをバイト単位で指定します。
dwFlagsDWORD4+4+4

ドライバーがどの Microsoft DirectDraw コールバック関数を実装しているかを示します。dwFlags で設定されたビットごとに、ドライバーはこの構造体の対応する関数ポインターメンバーを初期化しなければなりません。このメンバーには、次のフラグの 1 つ以上を指定できます:

DDHAL_CB32_CANCREATESURFACE
DDHAL_CB32_CREATEPALETTE
DDHAL_CB32_CREATESURFACE
DDHAL_CB32_GETSCANLINE
DDHAL_CB32_MAPMEMORY
DDHAL_CB32_SETCOLORKEY
DDHAL_CB32_SETMODE
DDHAL_CB32_WAITFORVERTICALBLANK
DestroyDriverPDD_DESTROYDRIVER8/4+8+8Microsoft Windows 2000 以降では使用されません。ドライバーはこのメンバーを無視してください。
CreateSurfacePDD_CREATESURFACE8/4+16+12ドライバーが提供する DdCreateSurface コールバックを指します。
SetColorKeyPDD_SETCOLORKEY8/4+24+16ドライバーが提供する DdSetColorKey コールバックを指します。
SetModePDD_SETMODE8/4+32+20Windows 2000 以降では使用されません。ドライバーはこのメンバーを無視してください。
WaitForVerticalBlankPDD_WAITFORVERTICALBLANK8/4+40+24ドライバーが提供する DdWaitForVerticalBlank コールバックを指します。
CanCreateSurfacePDD_CANCREATESURFACE8/4+48+28ドライバーが提供する DdCanCreateSurface コールバックを指します。
CreatePalettePDD_CREATEPALETTE8/4+56+32ドライバーが提供する DdCreatePalette コールバックを指します。
GetScanLinePDD_GETSCANLINE8/4+64+36ドライバーが提供する DdGetScanLine コールバックを指します。
MapMemoryPDD_MAPMEMORY8/4+72+40ドライバーが提供する DdMapMemory コールバックを指します。

公式ドキュメント

DD_CALLBACKS 構造体には、デバイスドライバーがサポートするコールバック関数へのエントリポインターが格納されます。

解説(Remarks)

ディスプレイドライバーが使用しないエントリは NULL に設定してください。GDI はこの構造体のメモリを割り当て、それを初期化するためにドライバーの DrvEnableDirectDraw 関数を呼び出します。

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

各言語での定義

#include <windows.h>

// DD_CALLBACKS  (x64 80 / x86 44 バイト)
typedef struct DD_CALLBACKS {
    DWORD dwSize;
    DWORD dwFlags;
    PDD_DESTROYDRIVER DestroyDriver;
    PDD_CREATESURFACE CreateSurface;
    PDD_SETCOLORKEY SetColorKey;
    PDD_SETMODE SetMode;
    PDD_WAITFORVERTICALBLANK WaitForVerticalBlank;
    PDD_CANCREATESURFACE CanCreateSurface;
    PDD_CREATEPALETTE CreatePalette;
    PDD_GETSCANLINE GetScanLine;
    PDD_MAPMEMORY MapMemory;
} DD_CALLBACKS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_CALLBACKS
{
    public uint dwSize;
    public uint dwFlags;
    public IntPtr DestroyDriver;
    public IntPtr CreateSurface;
    public IntPtr SetColorKey;
    public IntPtr SetMode;
    public IntPtr WaitForVerticalBlank;
    public IntPtr CanCreateSurface;
    public IntPtr CreatePalette;
    public IntPtr GetScanLine;
    public IntPtr MapMemory;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_CALLBACKS
    Public dwSize As UInteger
    Public dwFlags As UInteger
    Public DestroyDriver As IntPtr
    Public CreateSurface As IntPtr
    Public SetColorKey As IntPtr
    Public SetMode As IntPtr
    Public WaitForVerticalBlank As IntPtr
    Public CanCreateSurface As IntPtr
    Public CreatePalette As IntPtr
    Public GetScanLine As IntPtr
    Public MapMemory As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DD_CALLBACKS(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("DestroyDriver", ctypes.c_void_p),
        ("CreateSurface", ctypes.c_void_p),
        ("SetColorKey", ctypes.c_void_p),
        ("SetMode", ctypes.c_void_p),
        ("WaitForVerticalBlank", ctypes.c_void_p),
        ("CanCreateSurface", ctypes.c_void_p),
        ("CreatePalette", ctypes.c_void_p),
        ("GetScanLine", ctypes.c_void_p),
        ("MapMemory", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DD_CALLBACKS {
    pub dwSize: u32,
    pub dwFlags: u32,
    pub DestroyDriver: *mut core::ffi::c_void,
    pub CreateSurface: *mut core::ffi::c_void,
    pub SetColorKey: *mut core::ffi::c_void,
    pub SetMode: *mut core::ffi::c_void,
    pub WaitForVerticalBlank: *mut core::ffi::c_void,
    pub CanCreateSurface: *mut core::ffi::c_void,
    pub CreatePalette: *mut core::ffi::c_void,
    pub GetScanLine: *mut core::ffi::c_void,
    pub MapMemory: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DD_CALLBACKS struct {
	dwSize uint32
	dwFlags uint32
	DestroyDriver uintptr
	CreateSurface uintptr
	SetColorKey uintptr
	SetMode uintptr
	WaitForVerticalBlank uintptr
	CanCreateSurface uintptr
	CreatePalette uintptr
	GetScanLine uintptr
	MapMemory uintptr
}
type
  DD_CALLBACKS = record
    dwSize: DWORD;
    dwFlags: DWORD;
    DestroyDriver: Pointer;
    CreateSurface: Pointer;
    SetColorKey: Pointer;
    SetMode: Pointer;
    WaitForVerticalBlank: Pointer;
    CanCreateSurface: Pointer;
    CreatePalette: Pointer;
    GetScanLine: Pointer;
    MapMemory: Pointer;
  end;
const DD_CALLBACKS = extern struct {
    dwSize: u32,
    dwFlags: u32,
    DestroyDriver: ?*anyopaque,
    CreateSurface: ?*anyopaque,
    SetColorKey: ?*anyopaque,
    SetMode: ?*anyopaque,
    WaitForVerticalBlank: ?*anyopaque,
    CanCreateSurface: ?*anyopaque,
    CreatePalette: ?*anyopaque,
    GetScanLine: ?*anyopaque,
    MapMemory: ?*anyopaque,
};
type
  DD_CALLBACKS {.bycopy.} = object
    dwSize: uint32
    dwFlags: uint32
    DestroyDriver: pointer
    CreateSurface: pointer
    SetColorKey: pointer
    SetMode: pointer
    WaitForVerticalBlank: pointer
    CanCreateSurface: pointer
    CreatePalette: pointer
    GetScanLine: pointer
    MapMemory: pointer
struct DD_CALLBACKS
{
    uint dwSize;
    uint dwFlags;
    void* DestroyDriver;
    void* CreateSurface;
    void* SetColorKey;
    void* SetMode;
    void* WaitForVerticalBlank;
    void* CanCreateSurface;
    void* CreatePalette;
    void* GetScanLine;
    void* MapMemory;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_CALLBACKS サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DestroyDriver : PDD_DESTROYDRIVER (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; CreateSurface : PDD_CREATESURFACE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; SetColorKey : PDD_SETCOLORKEY (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; SetMode : PDD_SETMODE (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; WaitForVerticalBlank : PDD_WAITFORVERTICALBLANK (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; CanCreateSurface : PDD_CANCREATESURFACE (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; CreatePalette : PDD_CREATEPALETTE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; GetScanLine : PDD_GETSCANLINE (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; MapMemory : PDD_MAPMEMORY (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_CALLBACKS サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DestroyDriver : PDD_DESTROYDRIVER (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; CreateSurface : PDD_CREATESURFACE (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; SetColorKey : PDD_SETCOLORKEY (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; SetMode : PDD_SETMODE (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; WaitForVerticalBlank : PDD_WAITFORVERTICALBLANK (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; CanCreateSurface : PDD_CANCREATESURFACE (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; CreatePalette : PDD_CREATEPALETTE (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; GetScanLine : PDD_GETSCANLINE (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; MapMemory : PDD_MAPMEMORY (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DD_CALLBACKS
    #field int dwSize
    #field int dwFlags
    #field intptr DestroyDriver
    #field intptr CreateSurface
    #field intptr SetColorKey
    #field intptr SetMode
    #field intptr WaitForVerticalBlank
    #field intptr CanCreateSurface
    #field intptr CreatePalette
    #field intptr GetScanLine
    #field intptr MapMemory
#endstruct

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