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

DDTRANSFERININFO

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

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

フィールド

フィールドサイズx64x86説明
lpSurfaceDataDDSURFACEDATA*8/4+0+0転送する情報を含むサーフェスを表す DDSURFACEDATA 構造体を指します。この構造体の情報は DirectDraw によって提供されます。
dwStartLineDWORD4+8+4データの転送元となるサーフェス内の最初の行を示します。
dwEndLineDWORD4+12+8データの転送元となるサーフェス内の最後の行を示します (この行を含みます)。
dwTransferIDUINT_PTR8/4+16+12DirectDraw によって提供される転送の識別子を指定します。この転送 ID は、ドライバーが DDGETTRANSFERSTATUSOUTINFO 構造体で使用します。
dwTransferFlagsDWORD4+24+16

転送の種類を示します。次のいずれかです:

フラグ 意味
DDTRANSFER_CANCEL DirectDraw は以前に転送を要求しましたが、現在その要求を取り消しています。
DDTRANSFER_HALFLINES ハーフラインの問題により、奇数フィールドの先頭には不要なデータの行が 1 行余分に含まれるため、ドライバーはこれを考慮する必要があります。
DDTRANSFER_INVERT バスマスタリング中に、キャプチャドライバーが反転を要求しています。
DDTRANSFER_NONLOCALVIDMEM ディスプレイメモリから AGP メモリへの転送です。
DDTRANSFER_SYSTEMMEMORY ディスプレイメモリからシステムメモリへの転送です。
lpDestMDLDDMDL*8/4+32+20転送先の メモリ記述子リスト (MDL) 構造体を指します。

公式ドキュメント

DDTRANSFERININFO 構造体には、サーフェスの転送情報が格納されます

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

各言語での定義

#include <windows.h>

// DDTRANSFERININFO  (x64 40 / x86 24 バイト)
typedef struct DDTRANSFERININFO {
    DDSURFACEDATA* lpSurfaceData;
    DWORD dwStartLine;
    DWORD dwEndLine;
    UINT_PTR dwTransferID;
    DWORD dwTransferFlags;
    DDMDL* lpDestMDL;
} DDTRANSFERININFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDTRANSFERININFO
{
    public IntPtr lpSurfaceData;
    public uint dwStartLine;
    public uint dwEndLine;
    public UIntPtr dwTransferID;
    public uint dwTransferFlags;
    public IntPtr lpDestMDL;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDTRANSFERININFO
    Public lpSurfaceData As IntPtr
    Public dwStartLine As UInteger
    Public dwEndLine As UInteger
    Public dwTransferID As UIntPtr
    Public dwTransferFlags As UInteger
    Public lpDestMDL As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DDTRANSFERININFO(ctypes.Structure):
    _fields_ = [
        ("lpSurfaceData", ctypes.c_void_p),
        ("dwStartLine", wintypes.DWORD),
        ("dwEndLine", wintypes.DWORD),
        ("dwTransferID", ctypes.c_size_t),
        ("dwTransferFlags", wintypes.DWORD),
        ("lpDestMDL", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DDTRANSFERININFO {
    pub lpSurfaceData: *mut core::ffi::c_void,
    pub dwStartLine: u32,
    pub dwEndLine: u32,
    pub dwTransferID: usize,
    pub dwTransferFlags: u32,
    pub lpDestMDL: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DDTRANSFERININFO struct {
	lpSurfaceData uintptr
	dwStartLine uint32
	dwEndLine uint32
	dwTransferID uintptr
	dwTransferFlags uint32
	lpDestMDL uintptr
}
type
  DDTRANSFERININFO = record
    lpSurfaceData: Pointer;
    dwStartLine: DWORD;
    dwEndLine: DWORD;
    dwTransferID: NativeUInt;
    dwTransferFlags: DWORD;
    lpDestMDL: Pointer;
  end;
const DDTRANSFERININFO = extern struct {
    lpSurfaceData: ?*anyopaque,
    dwStartLine: u32,
    dwEndLine: u32,
    dwTransferID: usize,
    dwTransferFlags: u32,
    lpDestMDL: ?*anyopaque,
};
type
  DDTRANSFERININFO {.bycopy.} = object
    lpSurfaceData: pointer
    dwStartLine: uint32
    dwEndLine: uint32
    dwTransferID: uint
    dwTransferFlags: uint32
    lpDestMDL: pointer
struct DDTRANSFERININFO
{
    void* lpSurfaceData;
    uint dwStartLine;
    uint dwEndLine;
    size_t dwTransferID;
    uint dwTransferFlags;
    void* lpDestMDL;
}

HSP用 定義

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

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

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