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

VIDEOMEMORYINFO

構造体
サイズx64: 96 バイト / x86: 76 バイト

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

フィールド

フィールドサイズx64x86説明
fpPrimaryUINT_PTR8/4+0+0ディスプレイメモリ内でのプライマリサーフェスまでのオフセットをバイト単位で指定します。
dwFlagsDWORD4+8+4現在使用されていません。0 に設定してください。
dwDisplayWidthDWORD4+12+8ディスプレイの現在の幅をピクセル単位で指定します。
dwDisplayHeightDWORD4+16+12ディスプレイの現在の高さをピクセル単位で指定します。
lDisplayPitchINT4+20+16ディスプレイの現在のピッチをバイト単位で指定します。
ddpfDisplayDDPIXELFORMAT40/32+24+20ディスプレイのピクセル形式が記述された DDPIXELFORMAT 構造体を指定します。
dwOffscreenAlignDWORD4+64+52オフスクリーンサーフェス用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。
dwOverlayAlignDWORD4+68+56オーバーレイプレーン用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。
dwTextureAlignDWORD4+72+60テクスチャ用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。
dwZBufferAlignDWORD4+76+64深度バッファー用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。
dwAlphaAlignDWORD4+80+68アルファバッファー用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。
pvPrimaryvoid*8/4+88+72

(Microsoft Windows 2000 以降のみ)

プライマリサーフェスの先頭を指すカーネルモードポインターを指定します。

公式ドキュメント

VIDEOMEMORYINFO 構造体は、ディスプレイのメモリの一般的な形式を記述します。

解説(Remarks)

VIDEOMEMORYINFO 構造体には、Windows 98/Me と Windows 2000 以降との間でわずかな違いがあります。Windows 2000 以降ではこのデータ構造体は VIDEOMEMORYINFO と呼ばれ、Windows 98/Me では VIDMEMINFO と呼ばれます。Windows 2000 以降の VIDEOMEMORYINFO には、プライマリサーフェスを指すカーネルモードポインターを格納するフィールド pvPrimary が含まれます。Windows 98/Me の VIDMEMINFO には、メモリヒープの配列を指定するフィールド dwNumHeaps および pvmList が含まれます。

GDI は VIDEOMEMORYINFO 構造体用のメモリを割り当て、この構造体を DD_HALINFO パラメーターのメンバーとしてドライバーの DrvGetDirectDrawInfo 関数に渡します。ドライバーは、デバイスのメモリの一般的な特性を記述するために適切なメンバーを設定する必要があります。

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

各言語での定義

#include <windows.h>

// DDPIXELFORMAT  (x64 40 / x86 32 バイト)
typedef struct DDPIXELFORMAT {
    DWORD dwSize;
    DWORD dwFlags;
    DWORD dwFourCC;
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    _Anonymous3_e__Union Anonymous3;
    _Anonymous4_e__Union Anonymous4;
    _Anonymous5_e__Union Anonymous5;
} DDPIXELFORMAT;

// VIDEOMEMORYINFO  (x64 96 / x86 76 バイト)
typedef struct VIDEOMEMORYINFO {
    UINT_PTR fpPrimary;
    DWORD dwFlags;
    DWORD dwDisplayWidth;
    DWORD dwDisplayHeight;
    INT lDisplayPitch;
    DDPIXELFORMAT ddpfDisplay;
    DWORD dwOffscreenAlign;
    DWORD dwOverlayAlign;
    DWORD dwTextureAlign;
    DWORD dwZBufferAlign;
    DWORD dwAlphaAlign;
    void* pvPrimary;
} VIDEOMEMORYINFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDPIXELFORMAT
{
    public uint dwSize;
    public uint dwFlags;
    public uint dwFourCC;
    public _Anonymous1_e__Union Anonymous1;
    public _Anonymous2_e__Union Anonymous2;
    public _Anonymous3_e__Union Anonymous3;
    public _Anonymous4_e__Union Anonymous4;
    public _Anonymous5_e__Union Anonymous5;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VIDEOMEMORYINFO
{
    public UIntPtr fpPrimary;
    public uint dwFlags;
    public uint dwDisplayWidth;
    public uint dwDisplayHeight;
    public int lDisplayPitch;
    public DDPIXELFORMAT ddpfDisplay;
    public uint dwOffscreenAlign;
    public uint dwOverlayAlign;
    public uint dwTextureAlign;
    public uint dwZBufferAlign;
    public uint dwAlphaAlign;
    public IntPtr pvPrimary;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDPIXELFORMAT
    Public dwSize As UInteger
    Public dwFlags As UInteger
    Public dwFourCC As UInteger
    Public Anonymous1 As _Anonymous1_e__Union
    Public Anonymous2 As _Anonymous2_e__Union
    Public Anonymous3 As _Anonymous3_e__Union
    Public Anonymous4 As _Anonymous4_e__Union
    Public Anonymous5 As _Anonymous5_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VIDEOMEMORYINFO
    Public fpPrimary As UIntPtr
    Public dwFlags As UInteger
    Public dwDisplayWidth As UInteger
    Public dwDisplayHeight As UInteger
    Public lDisplayPitch As Integer
    Public ddpfDisplay As DDPIXELFORMAT
    Public dwOffscreenAlign As UInteger
    Public dwOverlayAlign As UInteger
    Public dwTextureAlign As UInteger
    Public dwZBufferAlign As UInteger
    Public dwAlphaAlign As UInteger
    Public pvPrimary As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DDPIXELFORMAT(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("dwFourCC", wintypes.DWORD),
        ("Anonymous1", _Anonymous1_e__Union),
        ("Anonymous2", _Anonymous2_e__Union),
        ("Anonymous3", _Anonymous3_e__Union),
        ("Anonymous4", _Anonymous4_e__Union),
        ("Anonymous5", _Anonymous5_e__Union),
    ]

class VIDEOMEMORYINFO(ctypes.Structure):
    _fields_ = [
        ("fpPrimary", ctypes.c_size_t),
        ("dwFlags", wintypes.DWORD),
        ("dwDisplayWidth", wintypes.DWORD),
        ("dwDisplayHeight", wintypes.DWORD),
        ("lDisplayPitch", ctypes.c_int),
        ("ddpfDisplay", DDPIXELFORMAT),
        ("dwOffscreenAlign", wintypes.DWORD),
        ("dwOverlayAlign", wintypes.DWORD),
        ("dwTextureAlign", wintypes.DWORD),
        ("dwZBufferAlign", wintypes.DWORD),
        ("dwAlphaAlign", wintypes.DWORD),
        ("pvPrimary", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DDPIXELFORMAT {
    pub dwSize: u32,
    pub dwFlags: u32,
    pub dwFourCC: u32,
    pub Anonymous1: _Anonymous1_e__Union,
    pub Anonymous2: _Anonymous2_e__Union,
    pub Anonymous3: _Anonymous3_e__Union,
    pub Anonymous4: _Anonymous4_e__Union,
    pub Anonymous5: _Anonymous5_e__Union,
}

#[repr(C)]
pub struct VIDEOMEMORYINFO {
    pub fpPrimary: usize,
    pub dwFlags: u32,
    pub dwDisplayWidth: u32,
    pub dwDisplayHeight: u32,
    pub lDisplayPitch: i32,
    pub ddpfDisplay: DDPIXELFORMAT,
    pub dwOffscreenAlign: u32,
    pub dwOverlayAlign: u32,
    pub dwTextureAlign: u32,
    pub dwZBufferAlign: u32,
    pub dwAlphaAlign: u32,
    pub pvPrimary: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DDPIXELFORMAT struct {
	dwSize uint32
	dwFlags uint32
	dwFourCC uint32
	Anonymous1 _Anonymous1_e__Union
	Anonymous2 _Anonymous2_e__Union
	Anonymous3 _Anonymous3_e__Union
	Anonymous4 _Anonymous4_e__Union
	Anonymous5 _Anonymous5_e__Union
}

type VIDEOMEMORYINFO struct {
	fpPrimary uintptr
	dwFlags uint32
	dwDisplayWidth uint32
	dwDisplayHeight uint32
	lDisplayPitch int32
	ddpfDisplay DDPIXELFORMAT
	dwOffscreenAlign uint32
	dwOverlayAlign uint32
	dwTextureAlign uint32
	dwZBufferAlign uint32
	dwAlphaAlign uint32
	pvPrimary uintptr
}
type
  DDPIXELFORMAT = record
    dwSize: DWORD;
    dwFlags: DWORD;
    dwFourCC: DWORD;
    Anonymous1: _Anonymous1_e__Union;
    Anonymous2: _Anonymous2_e__Union;
    Anonymous3: _Anonymous3_e__Union;
    Anonymous4: _Anonymous4_e__Union;
    Anonymous5: _Anonymous5_e__Union;
  end;

  VIDEOMEMORYINFO = record
    fpPrimary: NativeUInt;
    dwFlags: DWORD;
    dwDisplayWidth: DWORD;
    dwDisplayHeight: DWORD;
    lDisplayPitch: Integer;
    ddpfDisplay: DDPIXELFORMAT;
    dwOffscreenAlign: DWORD;
    dwOverlayAlign: DWORD;
    dwTextureAlign: DWORD;
    dwZBufferAlign: DWORD;
    dwAlphaAlign: DWORD;
    pvPrimary: Pointer;
  end;
const DDPIXELFORMAT = extern struct {
    dwSize: u32,
    dwFlags: u32,
    dwFourCC: u32,
    Anonymous1: _Anonymous1_e__Union,
    Anonymous2: _Anonymous2_e__Union,
    Anonymous3: _Anonymous3_e__Union,
    Anonymous4: _Anonymous4_e__Union,
    Anonymous5: _Anonymous5_e__Union,
};

const VIDEOMEMORYINFO = extern struct {
    fpPrimary: usize,
    dwFlags: u32,
    dwDisplayWidth: u32,
    dwDisplayHeight: u32,
    lDisplayPitch: i32,
    ddpfDisplay: DDPIXELFORMAT,
    dwOffscreenAlign: u32,
    dwOverlayAlign: u32,
    dwTextureAlign: u32,
    dwZBufferAlign: u32,
    dwAlphaAlign: u32,
    pvPrimary: ?*anyopaque,
};
type
  DDPIXELFORMAT {.bycopy.} = object
    dwSize: uint32
    dwFlags: uint32
    dwFourCC: uint32
    Anonymous1: _Anonymous1_e__Union
    Anonymous2: _Anonymous2_e__Union
    Anonymous3: _Anonymous3_e__Union
    Anonymous4: _Anonymous4_e__Union
    Anonymous5: _Anonymous5_e__Union

  VIDEOMEMORYINFO {.bycopy.} = object
    fpPrimary: uint
    dwFlags: uint32
    dwDisplayWidth: uint32
    dwDisplayHeight: uint32
    lDisplayPitch: int32
    ddpfDisplay: DDPIXELFORMAT
    dwOffscreenAlign: uint32
    dwOverlayAlign: uint32
    dwTextureAlign: uint32
    dwZBufferAlign: uint32
    dwAlphaAlign: uint32
    pvPrimary: pointer
struct DDPIXELFORMAT
{
    uint dwSize;
    uint dwFlags;
    uint dwFourCC;
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    _Anonymous3_e__Union Anonymous3;
    _Anonymous4_e__Union Anonymous4;
    _Anonymous5_e__Union Anonymous5;
}

struct VIDEOMEMORYINFO
{
    size_t fpPrimary;
    uint dwFlags;
    uint dwDisplayWidth;
    uint dwDisplayHeight;
    int lDisplayPitch;
    DDPIXELFORMAT ddpfDisplay;
    uint dwOffscreenAlign;
    uint dwOverlayAlign;
    uint dwTextureAlign;
    uint dwZBufferAlign;
    uint dwAlphaAlign;
    void* pvPrimary;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; VIDEOMEMORYINFO サイズ: 76 バイト(x86)
dim st, 19    ; 4byte整数×19(構造体サイズ 76 / 4 切り上げ)
; fpPrimary : UINT_PTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwDisplayWidth : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwDisplayHeight : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lDisplayPitch : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ddpfDisplay : DDPIXELFORMAT (+20, 32byte)  varptr(st)+20 を基点に操作(32byte:入れ子/配列)
; dwOffscreenAlign : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; dwOverlayAlign : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; dwTextureAlign : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; dwZBufferAlign : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; dwAlphaAlign : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; pvPrimary : void* (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VIDEOMEMORYINFO サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; fpPrimary : UINT_PTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; dwFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwDisplayWidth : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwDisplayHeight : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lDisplayPitch : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ddpfDisplay : DDPIXELFORMAT (+24, 40byte)  varptr(st)+24 を基点に操作(40byte:入れ子/配列)
; dwOffscreenAlign : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; dwOverlayAlign : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; dwTextureAlign : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; dwZBufferAlign : DWORD (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; dwAlphaAlign : DWORD (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; pvPrimary : void* (+88, 8byte)  qpoke st,88,値 / qpeek(st,88)  ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DDPIXELFORMAT
    #field int dwSize
    #field int dwFlags
    #field int dwFourCC
    #field byte Anonymous1 4
    #field byte Anonymous2 4
    #field byte Anonymous3 8
    #field byte Anonymous4 4
    #field byte Anonymous5 4
#endstruct

#defstruct global VIDEOMEMORYINFO
    #field intptr fpPrimary
    #field int dwFlags
    #field int dwDisplayWidth
    #field int dwDisplayHeight
    #field int lDisplayPitch
    #field DDPIXELFORMAT ddpfDisplay
    #field int dwOffscreenAlign
    #field int dwOverlayAlign
    #field int dwTextureAlign
    #field int dwZBufferAlign
    #field int dwAlphaAlign
    #field intptr pvPrimary
#endstruct

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