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

DD_FLIPDATA

構造体
サイズx64: 56 バイト / x86: 32 バイト

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

フィールド

フィールドサイズx64x86説明
lpDDDD_DIRECTDRAW_GLOBAL*8/4+0+0ドライバーのデバイスを記述する DD_DIRECTDRAW_GLOBAL 構造体を指すポインターです。
lpSurfCurrDD_SURFACE_LOCAL*8/4+8+4現在のサーフェスを記述する DD_SURFACE_LOCAL 構造体を指すポインターです。
lpSurfTargDD_SURFACE_LOCAL*8/4+16+8ターゲットサーフェス、すなわちドライバーがフリップ先とするサーフェスを記述する DD_SURFACE_LOCAL 構造体を指すポインターです。
dwFlagsDWORD4+24+12

フリップの詳細をドライバーに伝えるフラグのセットを示します。このメンバーには、次のフラグのビット単位の OR を指定できます。

フラグ 意味
DDFLIP_DONOTWAIT アクセラレーターがビジー状態の場合に DDERR_WASSTILLDRAWING を返すよう指定します。既定値は DDFLIP_WAIT です。
DDFLIP_EVEN lpSurfTarg メンバーが指すサーフェスには、ビデオデータの偶数フィールドのみが含まれます。このフラグはサーフェスがオーバーレイの場合にのみ有効であり、DDFLIP_ODD とは相互に排他的です。
DDFLIP_ODD lpSurfTarg メンバーが指すサーフェスには、ビデオデータの奇数フィールドのみが含まれます。このフラグはサーフェスがオーバーレイの場合にのみ有効であり、DDFLIP_EVEN とは相互に排他的です。
DDFLIP_NOVSYNC ドライバーはフリップを実行し、直ちに制御を返します。通常、現在のバックバッファー (以前のフロントバッファー) は次の垂直帰線までは表示されたままになります。lpSurfCurr メンバーと lpSurfTarg メンバーが指すサーフェスに関する以降の操作では、物理的なフリップが完了したかどうかは確認されません。これにより、アプリケーションはモニターのリフレッシュレートよりも高い頻度でフリップを実行できますが、目に見えるアーティファクトが生じる可能性があります。
DDFLIP_INTERVAL2 ドライバーは 1 回おきの垂直同期でフリップを実行します。2 回目の垂直帰線が発生するまでは DDERR_WASSTILLDRAWING を返します。このフラグは DDFLIP_INTERVAL3 および DDFLIP_INTERVAL4 とは相互に排他的です。
DDFLIP_INTERVAL3 ドライバーは 3 回に 1 回の垂直同期でフリップを実行します。3 回目の垂直帰線が発生するまでは DDERR_WASSTILLDRAWING を返します。このフラグは DDFLIP_INTERVAL2 および DDFLIP_INTERVAL4 とは相互に排他的です。
DDFLIP_INTERVAL4 ドライバーは 4 回に 1 回の垂直同期でフリップを実行します。4 回目の垂直帰線が発生するまでは DDERR_WASSTILLDRAWING を返します。このフラグは DDFLIP_INTERVAL2 および DDFLIP_INTERVAL3 とは相互に排他的です。
DDFLIP_STEREO ステレオの自動フリップを有効にすることを指定します (ハードウェアが画面のリフレッシュごとに左右のバッファーを自動的に切り替えます)。
DDFLIP_WAIT フリップが完了するかエラーが発生するまで制御を返さないことを指定します。
ddRValHRESULT4+28+16ドライバーが DdFlip コールバックの戻り値を書き込む場所を指定します。戻り値 DD_OK は成功を示します。詳細については、Return Values for DirectDraw を参照してください。
Flipvoid*8/4+32+20Microsoft DirectDraw API が使用するメンバーであり、ドライバーが値を設定してはなりません。
lpSurfCurrLeftDD_SURFACE_LOCAL*8/4+40+24現在の左サーフェスを記述する DD_SURFACE_LOCAL 構造体を指すポインターです。
lpSurfTargLeftDD_SURFACE_LOCAL*8/4+48+28フリップ先となる左のターゲットサーフェスを記述する DD_SURFACE_LOCAL 構造体を指すポインターです。

公式ドキュメント

DD_FLIPDATA 構造体には、フリップを実行するために必要な情報が格納されます。

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

各言語での定義

#include <windows.h>

// DD_FLIPDATA  (x64 56 / x86 32 バイト)
typedef struct DD_FLIPDATA {
    DD_DIRECTDRAW_GLOBAL* lpDD;
    DD_SURFACE_LOCAL* lpSurfCurr;
    DD_SURFACE_LOCAL* lpSurfTarg;
    DWORD dwFlags;
    HRESULT ddRVal;
    void* Flip;
    DD_SURFACE_LOCAL* lpSurfCurrLeft;
    DD_SURFACE_LOCAL* lpSurfTargLeft;
} DD_FLIPDATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_FLIPDATA
{
    public IntPtr lpDD;
    public IntPtr lpSurfCurr;
    public IntPtr lpSurfTarg;
    public uint dwFlags;
    public int ddRVal;
    public IntPtr Flip;
    public IntPtr lpSurfCurrLeft;
    public IntPtr lpSurfTargLeft;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_FLIPDATA
    Public lpDD As IntPtr
    Public lpSurfCurr As IntPtr
    Public lpSurfTarg As IntPtr
    Public dwFlags As UInteger
    Public ddRVal As Integer
    Public Flip As IntPtr
    Public lpSurfCurrLeft As IntPtr
    Public lpSurfTargLeft As IntPtr
End Structure
import ctypes
from ctypes import wintypes

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

type DD_FLIPDATA struct {
	lpDD uintptr
	lpSurfCurr uintptr
	lpSurfTarg uintptr
	dwFlags uint32
	ddRVal int32
	Flip uintptr
	lpSurfCurrLeft uintptr
	lpSurfTargLeft uintptr
}
type
  DD_FLIPDATA = record
    lpDD: Pointer;
    lpSurfCurr: Pointer;
    lpSurfTarg: Pointer;
    dwFlags: DWORD;
    ddRVal: Integer;
    Flip: Pointer;
    lpSurfCurrLeft: Pointer;
    lpSurfTargLeft: Pointer;
  end;
const DD_FLIPDATA = extern struct {
    lpDD: ?*anyopaque,
    lpSurfCurr: ?*anyopaque,
    lpSurfTarg: ?*anyopaque,
    dwFlags: u32,
    ddRVal: i32,
    Flip: ?*anyopaque,
    lpSurfCurrLeft: ?*anyopaque,
    lpSurfTargLeft: ?*anyopaque,
};
type
  DD_FLIPDATA {.bycopy.} = object
    lpDD: pointer
    lpSurfCurr: pointer
    lpSurfTarg: pointer
    dwFlags: uint32
    ddRVal: int32
    Flip: pointer
    lpSurfCurrLeft: pointer
    lpSurfTargLeft: pointer
struct DD_FLIPDATA
{
    void* lpDD;
    void* lpSurfCurr;
    void* lpSurfTarg;
    uint dwFlags;
    int ddRVal;
    void* Flip;
    void* lpSurfCurrLeft;
    void* lpSurfTargLeft;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_FLIPDATA サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_GLOBAL* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; lpSurfCurr : DD_SURFACE_LOCAL* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; lpSurfTarg : DD_SURFACE_LOCAL* (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; dwFlags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ddRVal : HRESULT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; Flip : void* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpSurfCurrLeft : DD_SURFACE_LOCAL* (+24, 4byte)  varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; lpSurfTargLeft : DD_SURFACE_LOCAL* (+28, 4byte)  varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_FLIPDATA サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_GLOBAL* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; lpSurfCurr : DD_SURFACE_LOCAL* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; lpSurfTarg : DD_SURFACE_LOCAL* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; dwFlags : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ddRVal : HRESULT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; Flip : void* (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpSurfCurrLeft : DD_SURFACE_LOCAL* (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; lpSurfTargLeft : DD_SURFACE_LOCAL* (+48, 8byte)  varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DD_FLIPDATA
    #field intptr lpDD
    #field intptr lpSurfCurr
    #field intptr lpSurfTarg
    #field int dwFlags
    #field int ddRVal
    #field intptr Flip
    #field intptr lpSurfCurrLeft
    #field intptr lpSurfTargLeft
#endstruct

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