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

DD_SETENTRIESDATA

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

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

フィールド

フィールド型サイズx64x86説明
lpDDDD_DIRECTDRAW_GLOBAL*8/4+0+0ドライバーのデバイスを記述する DD_DIRECTDRAW_GLOBAL 構造体へのポインターです。
lpDDPaletteDD_PALETTE_GLOBAL*8/4+8+4DirectDrawPalette オブジェクトを表す DD_PALETTE_GLOBAL 構造体へのポインターです。
dwBaseDWORD4+16+8最初に変更するエントリの、カラーテーブル内における 0 から始まるインデックスを指定します。
dwNumEntriesDWORD4+20+12ドライバーが更新するパレットエントリの数を指定します。
lpEntriesPALETTEENTRY*8/4+24+16カラーテーブルを指定する PALETTEENTRY 構造体へのポインターです。PALETTEENTRY の詳細については、最新の Microsoft DirectX SDK のドキュメントを参照してください。
ddRValHRESULT4+32+20DdSetEntries コールバックの戻り値をドライバーが書き込む場所を指定します。詳細については、Return Values for DirectDraw を参照してください。
SetEntriesvoid*8/4+40+24Microsoft DirectDraw API が使用します。ドライバーが値を設定してはなりません。

公式ドキュメント

DD_SETENTRIESDATA 構造体は、パレットエントリを設定するために必要な情報を格納します。

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

各言語での定義

#include <windows.h>

// DD_SETENTRIESDATA  (x64 48 / x86 28 バイト)
typedef struct DD_SETENTRIESDATA {
    DD_DIRECTDRAW_GLOBAL* lpDD;
    DD_PALETTE_GLOBAL* lpDDPalette;
    DWORD dwBase;
    DWORD dwNumEntries;
    PALETTEENTRY* lpEntries;
    HRESULT ddRVal;
    void* SetEntries;
} DD_SETENTRIESDATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_SETENTRIESDATA
{
    public IntPtr lpDD;
    public IntPtr lpDDPalette;
    public uint dwBase;
    public uint dwNumEntries;
    public IntPtr lpEntries;
    public int ddRVal;
    public IntPtr SetEntries;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_SETENTRIESDATA
    Public lpDD As IntPtr
    Public lpDDPalette As IntPtr
    Public dwBase As UInteger
    Public dwNumEntries As UInteger
    Public lpEntries As IntPtr
    Public ddRVal As Integer
    Public SetEntries As IntPtr
End Structure
import ctypes
from ctypes import wintypes

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

type DD_SETENTRIESDATA struct {
	lpDD uintptr
	lpDDPalette uintptr
	dwBase uint32
	dwNumEntries uint32
	lpEntries uintptr
	ddRVal int32
	SetEntries uintptr
}
type
  DD_SETENTRIESDATA = record
    lpDD: Pointer;
    lpDDPalette: Pointer;
    dwBase: DWORD;
    dwNumEntries: DWORD;
    lpEntries: Pointer;
    ddRVal: Integer;
    SetEntries: Pointer;
  end;
const DD_SETENTRIESDATA = extern struct {
    lpDD: ?*anyopaque,
    lpDDPalette: ?*anyopaque,
    dwBase: u32,
    dwNumEntries: u32,
    lpEntries: ?*anyopaque,
    ddRVal: i32,
    SetEntries: ?*anyopaque,
};
type
  DD_SETENTRIESDATA {.bycopy.} = object
    lpDD: pointer
    lpDDPalette: pointer
    dwBase: uint32
    dwNumEntries: uint32
    lpEntries: pointer
    ddRVal: int32
    SetEntries: pointer
struct DD_SETENTRIESDATA
{
    void* lpDD;
    void* lpDDPalette;
    uint dwBase;
    uint dwNumEntries;
    void* lpEntries;
    int ddRVal;
    void* SetEntries;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_SETENTRIESDATA サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_GLOBAL* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; lpDDPalette : DD_PALETTE_GLOBAL* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; dwBase : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwNumEntries : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpEntries : PALETTEENTRY* (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; ddRVal : HRESULT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; SetEntries : void* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_SETENTRIESDATA サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_GLOBAL* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; lpDDPalette : DD_PALETTE_GLOBAL* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; dwBase : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwNumEntries : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpEntries : PALETTEENTRY* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ddRVal : HRESULT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; SetEntries : void* (+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_SETENTRIESDATA
    #field intptr lpDD
    #field intptr lpDDPalette
    #field int dwBase
    #field int dwNumEntries
    #field intptr lpEntries
    #field int ddRVal
    #field intptr SetEntries
#endstruct

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