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

DD_WAITFORVPORTSYNCDATA

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

サイズ=各フィールドのバイト数(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

ドライバーが待機する条件を示します。このメンバーには次のいずれかの値を指定できます。

フラグ 意味
DDVPWAIT_BEGIN ドライバーは次の垂直同期 (V-sync) の開始時に戻ります。
DDVPWAIT_END ドライバーは次の、または現在の垂直同期 (V-sync) の終了時に戻ります。
DDVPWAIT_LINE ドライバーは dwLine で指定された行の開始時に戻ります。
dwLineDWORD4+20+12dwFlagsDDVPWAIT_LINE の場合に、ドライバーが同期する行番号を指定します。dwFlagsDDVPWAIT_BEGIN または DDVPWAIT_END が設定されている場合、ドライバーはこのメンバーを無視します。
dwTimeOutDWORD4+24+16タイムアウトするまでにドライバーが待機する最大時間をミリ秒単位で指定します。
ddRValHRESULT4+28+20ドライバーが DdVideoPortWaitForSync コールバックの戻り値を書き込む場所を指定します。戻り値 DD_OK は成功を示します。詳細については、「Return Values for DirectDraw」を参照してください。
UpdateVideoPortvoid*8/4+32+24DirectDraw API が使用するメンバーであり、ドライバーが値を設定してはなりません。

公式ドキュメント

DD_WAITFORVPORTSYNCDATA 構造体には、ドライバーが ビデオポート拡張 (VPE) オブジェクトを同期するために必要な情報が格納されます。

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

各言語での定義

#include <windows.h>

// DD_WAITFORVPORTSYNCDATA  (x64 40 / x86 28 バイト)
typedef struct DD_WAITFORVPORTSYNCDATA {
    DD_DIRECTDRAW_LOCAL* lpDD;
    DD_VIDEOPORT_LOCAL* lpVideoPort;
    DWORD dwFlags;
    DWORD dwLine;
    DWORD dwTimeOut;
    HRESULT ddRVal;
    void* UpdateVideoPort;
} DD_WAITFORVPORTSYNCDATA;
using System;
using System.Runtime.InteropServices;

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

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

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

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

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_WAITFORVPORTSYNCDATA サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 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 も可)
; dwLine : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwTimeOut : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ddRVal : HRESULT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; UpdateVideoPort : void* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_WAITFORVPORTSYNCDATA サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 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 も可)
; dwLine : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwTimeOut : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ddRVal : HRESULT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; UpdateVideoPort : void* (+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_WAITFORVPORTSYNCDATA
    #field intptr lpDD
    #field intptr lpVideoPort
    #field int dwFlags
    #field int dwLine
    #field int dwTimeOut
    #field int ddRVal
    #field intptr UpdateVideoPort
#endstruct

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