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

DDVIDEOPORTINFO

構造体
サイズx64: 88 バイト / x86: 64 バイト

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0構造体のサイズをバイト単位で指定します。このメンバーは、構造体を使用する前に初期化しなければなりません。
dwOriginXDWORD4+4+4サーフェス内でのビデオ データの x 方向の配置をピクセル単位で示します。自動フリップが要求された場合、このオフセットはすべてのサーフェスに適用されます。
dwOriginYDWORD4+8+8サーフェス内でのビデオ データの y 方向の配置をピクセル単位で示します。自動フリップが要求された場合、このオフセットはすべてのサーフェスに適用されます。
dwVPFlagsDWORD4+12+12

ドライバーがビデオ データをどのように転送するかを指定するフラグのセットを示します。このメンバーには、次の値のビット単位の OR を指定できます。

フラグ 意味
DDVP_AUTOFLIP 自動フリップを実行します。自動フリップは、ハードウェア ビデオ ポートにアタッチされたオーバーレイ サーフェスと、そのサーフェスにアタッチされたオーバーレイ サーフェスとの間で実行されます。フリップの順序は、オーバーレイ サーフェスがアタッチされた順序です。
DDVP_CONVERT ビデオ データとターゲット サーフェスの形式が異なります。ドライバーは、ビデオ データをターゲット サーフェスの形式に変換します。
DDVP_CROP ドライバーは、rCrop メンバーの矩形を使用して、ビデオ データと VBI データの両方をクロップします。
DDVP_IGNOREVBIXCROP VBI データをクロップする際、ドライバーは左端と右端のクロップ座標を無視します。
DDVP_INTERLEAVE ビデオ データと VBI データの両方のインターレース フィールドを、メモリ内でインターリーブします。
DDVP_MIRRORLEFTRIGHT ビデオ データをフレーム バッファーに書き込む際に、左右を反転します。
DDVP_MIRRORUPDOWN ビデオ データをフレーム バッファーに書き込む際に、上下を反転します。
DDVP_NOINTERLEAVE DDVP_INTERLEAVE フラグが設定されている場合、ドライバーはビデオ データのみをインターリーブします。つまり、VBI データはインターリーブしません。
DDVP_OVERRIDEBOBWEAVE bob と weave の判断が他のインターフェイスによって上書きされないようにします。このフラグが設定されている場合、Microsoft DirectDraw は、カーネル モード ドライバーがカーネル モードのビデオ トランスポート機能を使用してハードウェアを bob モードと weave モードの間で切り替えることを許可しません。
DDVP_PRESCALE dwPrescaleWidth メンバーと dwPrescaleHeight メンバーに基づいてプリスケール (ズーム) を実行します。DDVP_VBINOSCALE が設定されている場合、ドライバーはビデオ データのみをプリスケールします。それ以外の場合は、ビデオ データと VBI データの両方をプリスケールします。
DDVP_SKIPEVENFIELDS ビデオ データと VBI データの両方について、偶数フィールドの入力を無視します。
DDVP_SKIPODDFIELDS ビデオ データと VBI データの両方について、奇数フィールドの入力を無視します。
DDVP_SYNCMASTER ハードウェア ビデオ ポートの VSYNC を使用して、グラフィックスの VSYNC を駆動します。
DDVP_VBICONVERT lpddpfVBIOutputFormat メンバーが指す DDPIXELFORMAT 構造体には、垂直帰線期間内のデータの変換に使用するデータが格納されています。
DDVP_VBINOSCALE 垂直帰線期間内のデータをスケーリングしません。
rCropRECT16+16+16クロップ用の矩形をピクセル単位で指定する RECT 構造体を指定します。このメンバーは、dwVPFlags メンバーに DDVP_CROP フラグが設定されている場合に有効な矩形を格納します。
dwPrescaleWidthDWORD4+32+32ビデオ データと VBI データをプリスケール (ズーム) する幅をピクセル単位で指定します。たとえば、ビデオ データの幅が 720 ピクセルで、クライアントが幅を半分にすることを要求する場合、クライアントは dwPrescaleWidth に 360 を指定します。このメンバーは、dwVPFlags メンバーに DDVP_PRESCALE フラグが設定されている場合に有効な幅を格納します。
dwPrescaleHeightDWORD4+36+36ビデオ データと VBI データをプリスケール (ズーム) する高さをピクセル単位で指定します。たとえば、ビデオ データが 240 ピクセルで、クライアントがそれを半分にすることを要求する場合、クライアントは dwPrescaleHeight に 120 を指定します。このメンバーは、dwVPFlags メンバーに DDVP_PRESCALE フラグが設定されている場合に有効な値を格納します。
lpddpfInputFormatDDPIXELFORMAT*8/4+40+40ビデオ ポート エクステンション (VPE) オブジェクトに書き込まれるビデオ データの形式を指定する DDPIXELFORMAT 構造体を指します。VPE オブジェクトが変換を実行する場合、この形式はターゲット サーフェスの形式と異なる場合があります。
lpddpfVBIInputFormatDDPIXELFORMAT*8/4+48+44垂直帰線期間内のデータの入力形式を指定する DDPIXELFORMAT 構造体を指します。
lpddpfVBIOutputFormatDDPIXELFORMAT*8/4+56+48垂直帰線期間内のデータの出力形式を指定する DDPIXELFORMAT 構造体を指します。
dwVBIHeightDWORD4+64+52垂直帰線期間内のデータのライン数を指定します。
dwReserved1UINT_PTR8/4+72+56システムで使用するために予約済みです。ドライバーはこのメンバーを無視してください。
dwReserved2UINT_PTR8/4+80+60システムで使用するために予約済みです。ドライバーはこのメンバーを無視してください。

公式ドキュメント

DDVIDEOPORTINFO 構造体は、ドライバーがビデオ データをサーフェス (または複数のサーフェス) へどのように転送するかを記述します。DDVIDEOPORTINFO は DD_VIDEOPORT_LOCAL 構造体のメンバーです。

解説(Remarks)

この構造体のすべてのメンバーはクライアントによって設定されるため、ドライバーがこれらを変更してはなりません。クライアントは通常、オーバーレイ ミキサーです。

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

各言語での定義

#include <windows.h>

// RECT  (x64 16 / x86 16 バイト)
typedef struct RECT {
    INT left;
    INT top;
    INT right;
    INT bottom;
} RECT;

// DDVIDEOPORTINFO  (x64 88 / x86 64 バイト)
typedef struct DDVIDEOPORTINFO {
    DWORD dwSize;
    DWORD dwOriginX;
    DWORD dwOriginY;
    DWORD dwVPFlags;
    RECT rCrop;
    DWORD dwPrescaleWidth;
    DWORD dwPrescaleHeight;
    DDPIXELFORMAT* lpddpfInputFormat;
    DDPIXELFORMAT* lpddpfVBIInputFormat;
    DDPIXELFORMAT* lpddpfVBIOutputFormat;
    DWORD dwVBIHeight;
    UINT_PTR dwReserved1;
    UINT_PTR dwReserved2;
} DDVIDEOPORTINFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RECT
{
    public int left;
    public int top;
    public int right;
    public int bottom;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDVIDEOPORTINFO
{
    public uint dwSize;
    public uint dwOriginX;
    public uint dwOriginY;
    public uint dwVPFlags;
    public RECT rCrop;
    public uint dwPrescaleWidth;
    public uint dwPrescaleHeight;
    public IntPtr lpddpfInputFormat;
    public IntPtr lpddpfVBIInputFormat;
    public IntPtr lpddpfVBIOutputFormat;
    public uint dwVBIHeight;
    public UIntPtr dwReserved1;
    public UIntPtr dwReserved2;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RECT
    Public left As Integer
    Public top As Integer
    Public right As Integer
    Public bottom As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDVIDEOPORTINFO
    Public dwSize As UInteger
    Public dwOriginX As UInteger
    Public dwOriginY As UInteger
    Public dwVPFlags As UInteger
    Public rCrop As RECT
    Public dwPrescaleWidth As UInteger
    Public dwPrescaleHeight As UInteger
    Public lpddpfInputFormat As IntPtr
    Public lpddpfVBIInputFormat As IntPtr
    Public lpddpfVBIOutputFormat As IntPtr
    Public dwVBIHeight As UInteger
    Public dwReserved1 As UIntPtr
    Public dwReserved2 As UIntPtr
End Structure
import ctypes
from ctypes import wintypes

class RECT(ctypes.Structure):
    _fields_ = [
        ("left", ctypes.c_int),
        ("top", ctypes.c_int),
        ("right", ctypes.c_int),
        ("bottom", ctypes.c_int),
    ]

class DDVIDEOPORTINFO(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwOriginX", wintypes.DWORD),
        ("dwOriginY", wintypes.DWORD),
        ("dwVPFlags", wintypes.DWORD),
        ("rCrop", RECT),
        ("dwPrescaleWidth", wintypes.DWORD),
        ("dwPrescaleHeight", wintypes.DWORD),
        ("lpddpfInputFormat", ctypes.c_void_p),
        ("lpddpfVBIInputFormat", ctypes.c_void_p),
        ("lpddpfVBIOutputFormat", ctypes.c_void_p),
        ("dwVBIHeight", wintypes.DWORD),
        ("dwReserved1", ctypes.c_size_t),
        ("dwReserved2", ctypes.c_size_t),
    ]
#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C)]
pub struct DDVIDEOPORTINFO {
    pub dwSize: u32,
    pub dwOriginX: u32,
    pub dwOriginY: u32,
    pub dwVPFlags: u32,
    pub rCrop: RECT,
    pub dwPrescaleWidth: u32,
    pub dwPrescaleHeight: u32,
    pub lpddpfInputFormat: *mut core::ffi::c_void,
    pub lpddpfVBIInputFormat: *mut core::ffi::c_void,
    pub lpddpfVBIOutputFormat: *mut core::ffi::c_void,
    pub dwVBIHeight: u32,
    pub dwReserved1: usize,
    pub dwReserved2: usize,
}
import "golang.org/x/sys/windows"

type RECT struct {
	left int32
	top int32
	right int32
	bottom int32
}

type DDVIDEOPORTINFO struct {
	dwSize uint32
	dwOriginX uint32
	dwOriginY uint32
	dwVPFlags uint32
	rCrop RECT
	dwPrescaleWidth uint32
	dwPrescaleHeight uint32
	lpddpfInputFormat uintptr
	lpddpfVBIInputFormat uintptr
	lpddpfVBIOutputFormat uintptr
	dwVBIHeight uint32
	dwReserved1 uintptr
	dwReserved2 uintptr
}
type
  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  DDVIDEOPORTINFO = record
    dwSize: DWORD;
    dwOriginX: DWORD;
    dwOriginY: DWORD;
    dwVPFlags: DWORD;
    rCrop: RECT;
    dwPrescaleWidth: DWORD;
    dwPrescaleHeight: DWORD;
    lpddpfInputFormat: Pointer;
    lpddpfVBIInputFormat: Pointer;
    lpddpfVBIOutputFormat: Pointer;
    dwVBIHeight: DWORD;
    dwReserved1: NativeUInt;
    dwReserved2: NativeUInt;
  end;
const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const DDVIDEOPORTINFO = extern struct {
    dwSize: u32,
    dwOriginX: u32,
    dwOriginY: u32,
    dwVPFlags: u32,
    rCrop: RECT,
    dwPrescaleWidth: u32,
    dwPrescaleHeight: u32,
    lpddpfInputFormat: ?*anyopaque,
    lpddpfVBIInputFormat: ?*anyopaque,
    lpddpfVBIOutputFormat: ?*anyopaque,
    dwVBIHeight: u32,
    dwReserved1: usize,
    dwReserved2: usize,
};
type
  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  DDVIDEOPORTINFO {.bycopy.} = object
    dwSize: uint32
    dwOriginX: uint32
    dwOriginY: uint32
    dwVPFlags: uint32
    rCrop: RECT
    dwPrescaleWidth: uint32
    dwPrescaleHeight: uint32
    lpddpfInputFormat: pointer
    lpddpfVBIInputFormat: pointer
    lpddpfVBIOutputFormat: pointer
    dwVBIHeight: uint32
    dwReserved1: uint
    dwReserved2: uint
struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

struct DDVIDEOPORTINFO
{
    uint dwSize;
    uint dwOriginX;
    uint dwOriginY;
    uint dwVPFlags;
    RECT rCrop;
    uint dwPrescaleWidth;
    uint dwPrescaleHeight;
    void* lpddpfInputFormat;
    void* lpddpfVBIInputFormat;
    void* lpddpfVBIOutputFormat;
    uint dwVBIHeight;
    size_t dwReserved1;
    size_t dwReserved2;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DDVIDEOPORTINFO サイズ: 64 バイト(x86)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwOriginX : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwOriginY : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwVPFlags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; rCrop : RECT (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; dwPrescaleWidth : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwPrescaleHeight : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lpddpfInputFormat : DDPIXELFORMAT* (+40, 4byte)  varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; lpddpfVBIInputFormat : DDPIXELFORMAT* (+44, 4byte)  varptr(st)+44 を基点に操作(4byte:入れ子/配列)
; lpddpfVBIOutputFormat : DDPIXELFORMAT* (+48, 4byte)  varptr(st)+48 を基点に操作(4byte:入れ子/配列)
; dwVBIHeight : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; dwReserved1 : UINT_PTR (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; dwReserved2 : UINT_PTR (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DDVIDEOPORTINFO サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwOriginX : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwOriginY : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwVPFlags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; rCrop : RECT (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; dwPrescaleWidth : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwPrescaleHeight : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lpddpfInputFormat : DDPIXELFORMAT* (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; lpddpfVBIInputFormat : DDPIXELFORMAT* (+48, 8byte)  varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; lpddpfVBIOutputFormat : DDPIXELFORMAT* (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; dwVBIHeight : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; dwReserved1 : UINT_PTR (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; dwReserved2 : UINT_PTR (+80, 8byte)  qpoke st,80,値 / qpeek(st,80)  ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global DDVIDEOPORTINFO
    #field int dwSize
    #field int dwOriginX
    #field int dwOriginY
    #field int dwVPFlags
    #field RECT rCrop
    #field int dwPrescaleWidth
    #field int dwPrescaleHeight
    #field intptr lpddpfInputFormat
    #field intptr lpddpfVBIInputFormat
    #field intptr lpddpfVBIOutputFormat
    #field int dwVBIHeight
    #field intptr dwReserved1
    #field intptr dwReserved2
#endstruct

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