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

DD_MISCELLANEOUS2CALLBACKS

構造体
サイズx64: 40 バイト / x86: 24 バイト

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

フィールド

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

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

DDHAL_MISC2CB32_CREATESURFACEEX
DDHAL_MISC2CB32_GETDRIVERSTATE
DDHAL_MISC2CB32_DESTROYDDLOCAL
AlphaBltPDD_ALPHABLT8/4+8+8未使用であり、NULL に設定しなければなりません。
CreateSurfaceExPDD_CREATESURFACEEX8/4+16+12ドライバーの D3dCreateSurfaceEx 実装を指します。このコールバックは、DirectDraw サーフェスと小さな整数のハンドルとの関連付けを作成します。
GetDriverStatePDD_GETDRIVERSTATE8/4+24+16ドライバーの D3dGetDriverState 実装を指します。
DestroyDDLocalPDD_DESTROYDDLOCAL8/4+32+20ドライバーの D3dDestroyDDLocal 実装を指します。デバイスコンテキストのローカルコピーを破棄するために使用されます。

公式ドキュメント

DD_MISCELLANEOUS2CALLBACKS 構造体は、各種コールバックルーチンのアドレスを返すために使用されます。これらのルーチンは Microsoft DirectX 7.0 以降で新たに追加されたもので、GUID_Miscellaneous2Callbacks GUID に応答することで DdGetDriverInfo を通じて公開されます。

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

各言語での定義

#include <windows.h>

// DD_MISCELLANEOUS2CALLBACKS  (x64 40 / x86 24 バイト)
typedef struct DD_MISCELLANEOUS2CALLBACKS {
    DWORD dwSize;
    DWORD dwFlags;
    PDD_ALPHABLT AlphaBlt;
    PDD_CREATESURFACEEX CreateSurfaceEx;
    PDD_GETDRIVERSTATE GetDriverState;
    PDD_DESTROYDDLOCAL DestroyDDLocal;
} DD_MISCELLANEOUS2CALLBACKS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_MISCELLANEOUS2CALLBACKS
{
    public uint dwSize;
    public uint dwFlags;
    public IntPtr AlphaBlt;
    public IntPtr CreateSurfaceEx;
    public IntPtr GetDriverState;
    public IntPtr DestroyDDLocal;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_MISCELLANEOUS2CALLBACKS
    Public dwSize As UInteger
    Public dwFlags As UInteger
    Public AlphaBlt As IntPtr
    Public CreateSurfaceEx As IntPtr
    Public GetDriverState As IntPtr
    Public DestroyDDLocal As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DD_MISCELLANEOUS2CALLBACKS(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("AlphaBlt", ctypes.c_void_p),
        ("CreateSurfaceEx", ctypes.c_void_p),
        ("GetDriverState", ctypes.c_void_p),
        ("DestroyDDLocal", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DD_MISCELLANEOUS2CALLBACKS {
    pub dwSize: u32,
    pub dwFlags: u32,
    pub AlphaBlt: *mut core::ffi::c_void,
    pub CreateSurfaceEx: *mut core::ffi::c_void,
    pub GetDriverState: *mut core::ffi::c_void,
    pub DestroyDDLocal: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DD_MISCELLANEOUS2CALLBACKS struct {
	dwSize uint32
	dwFlags uint32
	AlphaBlt uintptr
	CreateSurfaceEx uintptr
	GetDriverState uintptr
	DestroyDDLocal uintptr
}
type
  DD_MISCELLANEOUS2CALLBACKS = record
    dwSize: DWORD;
    dwFlags: DWORD;
    AlphaBlt: Pointer;
    CreateSurfaceEx: Pointer;
    GetDriverState: Pointer;
    DestroyDDLocal: Pointer;
  end;
const DD_MISCELLANEOUS2CALLBACKS = extern struct {
    dwSize: u32,
    dwFlags: u32,
    AlphaBlt: ?*anyopaque,
    CreateSurfaceEx: ?*anyopaque,
    GetDriverState: ?*anyopaque,
    DestroyDDLocal: ?*anyopaque,
};
type
  DD_MISCELLANEOUS2CALLBACKS {.bycopy.} = object
    dwSize: uint32
    dwFlags: uint32
    AlphaBlt: pointer
    CreateSurfaceEx: pointer
    GetDriverState: pointer
    DestroyDDLocal: pointer
struct DD_MISCELLANEOUS2CALLBACKS
{
    uint dwSize;
    uint dwFlags;
    void* AlphaBlt;
    void* CreateSurfaceEx;
    void* GetDriverState;
    void* DestroyDDLocal;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_MISCELLANEOUS2CALLBACKS サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; AlphaBlt : PDD_ALPHABLT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; CreateSurfaceEx : PDD_CREATESURFACEEX (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; GetDriverState : PDD_GETDRIVERSTATE (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DestroyDDLocal : PDD_DESTROYDDLOCAL (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_MISCELLANEOUS2CALLBACKS サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; AlphaBlt : PDD_ALPHABLT (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; CreateSurfaceEx : PDD_CREATESURFACEEX (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; GetDriverState : PDD_GETDRIVERSTATE (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; DestroyDDLocal : PDD_DESTROYDDLOCAL (+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_MISCELLANEOUS2CALLBACKS
    #field int dwSize
    #field int dwFlags
    #field intptr AlphaBlt
    #field intptr CreateSurfaceEx
    #field intptr GetDriverState
    #field intptr DestroyDDLocal
#endstruct

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