ホーム › Graphics.Direct3D9 › D3DDEVINFO_D3D9BANDWIDTHTIMINGS

D3DDEVINFO_D3D9BANDWIDTHTIMINGS

構造体

サイズx64: 20 バイト / x86: 20 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
MaxBandwidthUtilized	FLOAT	4	+0	+0	利用された最大帯域幅の割合。
FrontEndUploadMemoryUtilizedPercent	FLOAT	4	+4	+4	フロントエンドのメモリアップロード利用率(パーセント)。
VertexRateUtilizedPercent	FLOAT	4	+8	+8	頂点処理レートの利用率(パーセント)。
TriangleSetupRateUtilizedPercent	FLOAT	4	+12	+12	三角形セットアップレートの利用率(パーセント)。
FillRateUtilizedPercent	FLOAT	4	+16	+16	フィルレートの利用率(パーセント)。

公式ドキュメント

アプリケーションのパフォーマンスを理解するのに役立つスループットメトリックです。

解説(Remarks)

MaxBandwidthUtilized: Type: FLOAT; ホスト CPU から GPU への帯域幅、すなわち最大データ転送速度です。これは通常、CPU と GPU を接続する PCI バスまたは AGP バスの帯域幅です。
FrontEndUploadMemoryUtilizedPercent: Type: FLOAT; ホスト CPU から GPU へデータをアップロードするときに使用されたメモリの割合です。
VertexRateUtilizedPercent: Type: FLOAT; 頂点スループットの割合です。これは、理論上の最大頂点処理速度と比較した、処理された頂点の数です。
TriangleSetupRateUtilizedPercent: Type: FLOAT; 三角形セットアップのスループットの割合です。これは、理論上の最大三角形セットアップ速度と比較した、ラスタライズ用にセットアップされた三角形の数です。
FillRateUtilizedPercent: Type: FLOAT; ピクセルフィルスループットの割合です。これは、理論上のピクセルフィルと比較した、塗りつぶされたピクセルの数です。

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

各言語での定義

#include <windows.h>

// D3DDEVINFO_D3D9BANDWIDTHTIMINGS  (x64 20 / x86 20 バイト)
typedef struct D3DDEVINFO_D3D9BANDWIDTHTIMINGS {
    FLOAT MaxBandwidthUtilized;
    FLOAT FrontEndUploadMemoryUtilizedPercent;
    FLOAT VertexRateUtilizedPercent;
    FLOAT TriangleSetupRateUtilizedPercent;
    FLOAT FillRateUtilizedPercent;
} D3DDEVINFO_D3D9BANDWIDTHTIMINGS;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3DDEVINFO_D3D9BANDWIDTHTIMINGS
{
    public float MaxBandwidthUtilized;
    public float FrontEndUploadMemoryUtilizedPercent;
    public float VertexRateUtilizedPercent;
    public float TriangleSetupRateUtilizedPercent;
    public float FillRateUtilizedPercent;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3DDEVINFO_D3D9BANDWIDTHTIMINGS
    Public MaxBandwidthUtilized As Single
    Public FrontEndUploadMemoryUtilizedPercent As Single
    Public VertexRateUtilizedPercent As Single
    Public TriangleSetupRateUtilizedPercent As Single
    Public FillRateUtilizedPercent As Single
End Structure

import ctypes
from ctypes import wintypes

class D3DDEVINFO_D3D9BANDWIDTHTIMINGS(ctypes.Structure):
    _fields_ = [
        ("MaxBandwidthUtilized", ctypes.c_float),
        ("FrontEndUploadMemoryUtilizedPercent", ctypes.c_float),
        ("VertexRateUtilizedPercent", ctypes.c_float),
        ("TriangleSetupRateUtilizedPercent", ctypes.c_float),
        ("FillRateUtilizedPercent", ctypes.c_float),
    ]

#[repr(C)]
pub struct D3DDEVINFO_D3D9BANDWIDTHTIMINGS {
    pub MaxBandwidthUtilized: f32,
    pub FrontEndUploadMemoryUtilizedPercent: f32,
    pub VertexRateUtilizedPercent: f32,
    pub TriangleSetupRateUtilizedPercent: f32,
    pub FillRateUtilizedPercent: f32,
}

import "golang.org/x/sys/windows"

type D3DDEVINFO_D3D9BANDWIDTHTIMINGS struct {
	MaxBandwidthUtilized float32
	FrontEndUploadMemoryUtilizedPercent float32
	VertexRateUtilizedPercent float32
	TriangleSetupRateUtilizedPercent float32
	FillRateUtilizedPercent float32
}

type
  D3DDEVINFO_D3D9BANDWIDTHTIMINGS = record
    MaxBandwidthUtilized: Single;
    FrontEndUploadMemoryUtilizedPercent: Single;
    VertexRateUtilizedPercent: Single;
    TriangleSetupRateUtilizedPercent: Single;
    FillRateUtilizedPercent: Single;
  end;

const D3DDEVINFO_D3D9BANDWIDTHTIMINGS = extern struct {
    MaxBandwidthUtilized: f32,
    FrontEndUploadMemoryUtilizedPercent: f32,
    VertexRateUtilizedPercent: f32,
    TriangleSetupRateUtilizedPercent: f32,
    FillRateUtilizedPercent: f32,
};

type
  D3DDEVINFO_D3D9BANDWIDTHTIMINGS {.bycopy.} = object
    MaxBandwidthUtilized: float32
    FrontEndUploadMemoryUtilizedPercent: float32
    VertexRateUtilizedPercent: float32
    TriangleSetupRateUtilizedPercent: float32
    FillRateUtilizedPercent: float32

struct D3DDEVINFO_D3D9BANDWIDTHTIMINGS
{
    float MaxBandwidthUtilized;
    float FrontEndUploadMemoryUtilizedPercent;
    float VertexRateUtilizedPercent;
    float TriangleSetupRateUtilizedPercent;
    float FillRateUtilizedPercent;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3DDEVINFO_D3D9BANDWIDTHTIMINGS サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; MaxBandwidthUtilized : FLOAT (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; FrontEndUploadMemoryUtilizedPercent : FLOAT (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; VertexRateUtilizedPercent : FLOAT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; TriangleSetupRateUtilizedPercent : FLOAT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; FillRateUtilizedPercent : FLOAT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3DDEVINFO_D3D9BANDWIDTHTIMINGS
    #field float MaxBandwidthUtilized
    #field float FrontEndUploadMemoryUtilizedPercent
    #field float VertexRateUtilizedPercent
    #field float TriangleSetupRateUtilizedPercent
    #field float FillRateUtilizedPercent
#endstruct

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