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

DD_VPORTCOLORDATA

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

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

フィールド

フィールドサイズx64x86説明
lpDDDD_DIRECTDRAW_LOCAL*8/4+0+0現在の Microsoft DirectDraw プロセスにのみ関係する DD_DIRECTDRAW_LOCAL 構造体を指します。
lpVideoPortDD_VIDEOPORT_LOCAL*8/4+8+4この VPE オブジェクトを表す DD_VIDEOPORT_LOCAL 構造体を指します。
dwFlagsDWORD4+16+8

ドライバーが実行するカラー コントロール操作を指定します。このメンバーには次のいずれかの値を指定できます。

フラグ 意味
DDRAWI_VPORTGETCOLOR ドライバーは、lpColorData が指す DDCOLORCONTROL 構造体に現在の VPE オブジェクトのカラー コントロールを書き込みます。
DDRAWI_VPORTSETCOLOR ドライバーは、lpColorData が指す DDCOLORCONTROL 構造体の内容に基づいて、VPE オブジェクトのカラー コントロールに新しい値を設定します。
lpColorDataDDCOLORCONTROL*8/4+24+12lpVideoPort が指す VPE オブジェクトに関連付けられたカラー コントロールを定義する DDCOLORCONTROL 構造体を指します。ドライバーがこの構造体から読み取るか、この構造体に書き込むかは、dwFlags の値によって決まります。
ddRValHRESULT4+32+16ドライバーが DdVideoPortColorControl コールバックの戻り値を書き込む場所を指定します。戻りコード DD_OK は成功を示します。詳細については、Return Values for DirectDraw を参照してください。
ColorControlvoid*8/4+40+20DirectDraw API が使用するメンバーであり、ドライバーが値を設定してはなりません。

公式ドキュメント

DD_VPORTCOLORDATA 構造体は、ビデオ ポート拡張 (VPE) オブジェクトのカラー コントロール情報を格納します。

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

各言語での定義

#include <windows.h>

// DD_VPORTCOLORDATA  (x64 48 / x86 24 バイト)
typedef struct DD_VPORTCOLORDATA {
    DD_DIRECTDRAW_LOCAL* lpDD;
    DD_VIDEOPORT_LOCAL* lpVideoPort;
    DWORD dwFlags;
    DDCOLORCONTROL* lpColorData;
    HRESULT ddRVal;
    void* ColorControl;
} DD_VPORTCOLORDATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_VPORTCOLORDATA
{
    public IntPtr lpDD;
    public IntPtr lpVideoPort;
    public uint dwFlags;
    public IntPtr lpColorData;
    public int ddRVal;
    public IntPtr ColorControl;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_VPORTCOLORDATA
    Public lpDD As IntPtr
    Public lpVideoPort As IntPtr
    Public dwFlags As UInteger
    Public lpColorData As IntPtr
    Public ddRVal As Integer
    Public ColorControl As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DD_VPORTCOLORDATA(ctypes.Structure):
    _fields_ = [
        ("lpDD", ctypes.c_void_p),
        ("lpVideoPort", ctypes.c_void_p),
        ("dwFlags", wintypes.DWORD),
        ("lpColorData", ctypes.c_void_p),
        ("ddRVal", ctypes.c_int),
        ("ColorControl", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DD_VPORTCOLORDATA {
    pub lpDD: *mut core::ffi::c_void,
    pub lpVideoPort: *mut core::ffi::c_void,
    pub dwFlags: u32,
    pub lpColorData: *mut core::ffi::c_void,
    pub ddRVal: i32,
    pub ColorControl: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DD_VPORTCOLORDATA struct {
	lpDD uintptr
	lpVideoPort uintptr
	dwFlags uint32
	lpColorData uintptr
	ddRVal int32
	ColorControl uintptr
}
type
  DD_VPORTCOLORDATA = record
    lpDD: Pointer;
    lpVideoPort: Pointer;
    dwFlags: DWORD;
    lpColorData: Pointer;
    ddRVal: Integer;
    ColorControl: Pointer;
  end;
const DD_VPORTCOLORDATA = extern struct {
    lpDD: ?*anyopaque,
    lpVideoPort: ?*anyopaque,
    dwFlags: u32,
    lpColorData: ?*anyopaque,
    ddRVal: i32,
    ColorControl: ?*anyopaque,
};
type
  DD_VPORTCOLORDATA {.bycopy.} = object
    lpDD: pointer
    lpVideoPort: pointer
    dwFlags: uint32
    lpColorData: pointer
    ddRVal: int32
    ColorControl: pointer
struct DD_VPORTCOLORDATA
{
    void* lpDD;
    void* lpVideoPort;
    uint dwFlags;
    void* lpColorData;
    int ddRVal;
    void* ColorControl;
}

HSP用 定義

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

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

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