VIDEOMEMORYINFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| fpPrimary | UINT_PTR | 8/4 | +0 | +0 | ディスプレイメモリ内でのプライマリサーフェスまでのオフセットをバイト単位で指定します。 |
| dwFlags | DWORD | 4 | +8 | +4 | 現在使用されていません。0 に設定してください。 |
| dwDisplayWidth | DWORD | 4 | +12 | +8 | ディスプレイの現在の幅をピクセル単位で指定します。 |
| dwDisplayHeight | DWORD | 4 | +16 | +12 | ディスプレイの現在の高さをピクセル単位で指定します。 |
| lDisplayPitch | INT | 4 | +20 | +16 | ディスプレイの現在のピッチをバイト単位で指定します。 |
| ddpfDisplay | DDPIXELFORMAT | 40/32 | +24 | +20 | ディスプレイのピクセル形式が記述された DDPIXELFORMAT 構造体を指定します。 |
| dwOffscreenAlign | DWORD | 4 | +64 | +52 | オフスクリーンサーフェス用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。 |
| dwOverlayAlign | DWORD | 4 | +68 | +56 | オーバーレイプレーン用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。 |
| dwTextureAlign | DWORD | 4 | +72 | +60 | テクスチャ用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。 |
| dwZBufferAlign | DWORD | 4 | +76 | +64 | 深度バッファー用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。 |
| dwAlphaAlign | DWORD | 4 | +80 | +68 | アルファバッファー用にこのメモリを割り当てる際に必要となるバイトアラインメントをバイト単位で指定します。 |
| pvPrimary | void* | 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 公式リファレンス: 英語 (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 Structureimport 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: pointerstruct 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