ホーム › Graphics.DirectDraw › DD_CALLBACKS
DD_CALLBACKS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | この構造体のサイズをバイト単位で指定します。 |
| dwFlags | DWORD | 4 | +4 | +4 | ドライバーがどの Microsoft DirectDraw コールバック関数を実装しているかを示します。dwFlags で設定されたビットごとに、ドライバーはこの構造体の対応する関数ポインターメンバーを初期化しなければなりません。このメンバーには、次のフラグの 1 つ以上を指定できます: |
| DestroyDriver | PDD_DESTROYDRIVER | 8/4 | +8 | +8 | Microsoft Windows 2000 以降では使用されません。ドライバーはこのメンバーを無視してください。 |
| CreateSurface | PDD_CREATESURFACE | 8/4 | +16 | +12 | ドライバーが提供する DdCreateSurface コールバックを指します。 |
| SetColorKey | PDD_SETCOLORKEY | 8/4 | +24 | +16 | ドライバーが提供する DdSetColorKey コールバックを指します。 |
| SetMode | PDD_SETMODE | 8/4 | +32 | +20 | Windows 2000 以降では使用されません。ドライバーはこのメンバーを無視してください。 |
| WaitForVerticalBlank | PDD_WAITFORVERTICALBLANK | 8/4 | +40 | +24 | ドライバーが提供する DdWaitForVerticalBlank コールバックを指します。 |
| CanCreateSurface | PDD_CANCREATESURFACE | 8/4 | +48 | +28 | ドライバーが提供する DdCanCreateSurface コールバックを指します。 |
| CreatePalette | PDD_CREATEPALETTE | 8/4 | +56 | +32 | ドライバーが提供する DdCreatePalette コールバックを指します。 |
| GetScanLine | PDD_GETSCANLINE | 8/4 | +64 | +36 | ドライバーが提供する DdGetScanLine コールバックを指します。 |
| MapMemory | PDD_MAPMEMORY | 8/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)
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 Structureimport 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: pointerstruct 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