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

DD_GETAVAILDRIVERMEMORYDATA

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

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

フィールド

フィールドサイズx64x86説明
lpDDDD_DIRECTDRAW_GLOBAL*8/4+0+0ドライバーのデバイスを記述する DD_DIRECTDRAW_GLOBAL 構造体を指すポインターです。
DDSCapsDDSCAPS4+8+4メモリの空き状況を照会する対象のサーフェスの種類を記述する DDSCAPS 構造体を指すポインターです。
dwTotalDWORD4+12+8DDSCaps で記述された種類のサーフェスに使用できる、ドライバー管理メモリのバイト数をドライバーが返す場所を指定します。
dwFreeDWORD4+16+12DDSCaps で記述されたサーフェスの種類について、空きメモリの量をバイト単位でドライバーが返す場所を指定します。
ddRValHRESULT4+20+16DdGetAvailDriverMemory コールバックの戻り値をドライバーが書き込む場所を指定します。戻り値 DD_OK は成功を示します。詳細については、Return Values for DirectDraw を参照してください。
GetAvailDriverMemoryvoid*8/4+24+20Microsoft DirectDraw API が使用するメンバーであり、ドライバーが値を設定してはなりません。

公式ドキュメント

DD_GETAVAILDRIVERMEMORYDATA 構造体は、空きメモリの量を照会して返すためにドライバーが必要とする情報を格納します。

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

各言語での定義

#include <windows.h>

// DDSCAPS  (x64 4 / x86 4 バイト)
typedef struct DDSCAPS {
    DWORD dwCaps;
} DDSCAPS;

// DD_GETAVAILDRIVERMEMORYDATA  (x64 32 / x86 24 バイト)
typedef struct DD_GETAVAILDRIVERMEMORYDATA {
    DD_DIRECTDRAW_GLOBAL* lpDD;
    DDSCAPS DDSCaps;
    DWORD dwTotal;
    DWORD dwFree;
    HRESULT ddRVal;
    void* GetAvailDriverMemory;
} DD_GETAVAILDRIVERMEMORYDATA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DDSCAPS
{
    public uint dwCaps;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DD_GETAVAILDRIVERMEMORYDATA
{
    public IntPtr lpDD;
    public DDSCAPS DDSCaps;
    public uint dwTotal;
    public uint dwFree;
    public int ddRVal;
    public IntPtr GetAvailDriverMemory;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DDSCAPS
    Public dwCaps As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DD_GETAVAILDRIVERMEMORYDATA
    Public lpDD As IntPtr
    Public DDSCaps As DDSCAPS
    Public dwTotal As UInteger
    Public dwFree As UInteger
    Public ddRVal As Integer
    Public GetAvailDriverMemory As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DDSCAPS(ctypes.Structure):
    _fields_ = [
        ("dwCaps", wintypes.DWORD),
    ]

class DD_GETAVAILDRIVERMEMORYDATA(ctypes.Structure):
    _fields_ = [
        ("lpDD", ctypes.c_void_p),
        ("DDSCaps", DDSCAPS),
        ("dwTotal", wintypes.DWORD),
        ("dwFree", wintypes.DWORD),
        ("ddRVal", ctypes.c_int),
        ("GetAvailDriverMemory", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DDSCAPS {
    pub dwCaps: u32,
}

#[repr(C)]
pub struct DD_GETAVAILDRIVERMEMORYDATA {
    pub lpDD: *mut core::ffi::c_void,
    pub DDSCaps: DDSCAPS,
    pub dwTotal: u32,
    pub dwFree: u32,
    pub ddRVal: i32,
    pub GetAvailDriverMemory: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DDSCAPS struct {
	dwCaps uint32
}

type DD_GETAVAILDRIVERMEMORYDATA struct {
	lpDD uintptr
	DDSCaps DDSCAPS
	dwTotal uint32
	dwFree uint32
	ddRVal int32
	GetAvailDriverMemory uintptr
}
type
  DDSCAPS = record
    dwCaps: DWORD;
  end;

  DD_GETAVAILDRIVERMEMORYDATA = record
    lpDD: Pointer;
    DDSCaps: DDSCAPS;
    dwTotal: DWORD;
    dwFree: DWORD;
    ddRVal: Integer;
    GetAvailDriverMemory: Pointer;
  end;
const DDSCAPS = extern struct {
    dwCaps: u32,
};

const DD_GETAVAILDRIVERMEMORYDATA = extern struct {
    lpDD: ?*anyopaque,
    DDSCaps: DDSCAPS,
    dwTotal: u32,
    dwFree: u32,
    ddRVal: i32,
    GetAvailDriverMemory: ?*anyopaque,
};
type
  DDSCAPS {.bycopy.} = object
    dwCaps: uint32

  DD_GETAVAILDRIVERMEMORYDATA {.bycopy.} = object
    lpDD: pointer
    DDSCaps: DDSCAPS
    dwTotal: uint32
    dwFree: uint32
    ddRVal: int32
    GetAvailDriverMemory: pointer
struct DDSCAPS
{
    uint dwCaps;
}

struct DD_GETAVAILDRIVERMEMORYDATA
{
    void* lpDD;
    DDSCAPS DDSCaps;
    uint dwTotal;
    uint dwFree;
    int ddRVal;
    void* GetAvailDriverMemory;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DD_GETAVAILDRIVERMEMORYDATA サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_GLOBAL* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; DDSCaps : DDSCAPS (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; dwTotal : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwFree : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ddRVal : HRESULT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; GetAvailDriverMemory : void* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DD_GETAVAILDRIVERMEMORYDATA サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; lpDD : DD_DIRECTDRAW_GLOBAL* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; DDSCaps : DDSCAPS (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; dwTotal : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwFree : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ddRVal : HRESULT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; GetAvailDriverMemory : void* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DDSCAPS
    #field int dwCaps
#endstruct

#defstruct global DD_GETAVAILDRIVERMEMORYDATA
    #field intptr lpDD
    #field DDSCAPS DDSCaps
    #field int dwTotal
    #field int dwFree
    #field int ddRVal
    #field intptr GetAvailDriverMemory
#endstruct

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