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

DXGI_FRAME_STATISTICS

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 32 バイト / x86: 32 バイト

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

フィールド

フィールド型サイズx64x86説明
PresentCountDWORD4+0+0

コンピューターの起動以降に、イメージがモニターに表示された累計回数を表す値です。

Note イメージがモニターに表示された回数は、IDXGISwapChain::Present または IDXGISwapChain1::Present1 を呼び出した回数と必ずしも同じではありません。
PresentRefreshCountDWORD4+4+4最後のイメージがモニターに表示された時点の v-blank について、コンピューターの起動以降 (ウィンドウモードの場合はスワップチェーンの作成以降) に発生した累計回数を表す値です。
SyncRefreshCountDWORD4+8+8スケジューラーが QueryPerformanceCounter を呼び出してマシン時間を最後にサンプリングした時点の v-blank について、コンピューターの起動以降 (ウィンドウモードの場合はスワップチェーンの作成以降) に発生した累計回数を表す値です。
SyncQPCTimeLONGLONG8+16+16高分解能パフォーマンスカウンタータイマーを表す値です。この値は、QueryPerformanceCounter 関数が返す値と同じです。
SyncGPUTimeLONGLONG8+24+24予約済みです。常に 0 を返します。

公式ドキュメント

フレームのタイミングおよび表示に関する統計情報を記述します。

解説(Remarks)

DXGI_FRAME_STATISTICS 構造体は、IDXGIOutput::GetFrameStatistics メソッドまたは IDXGISwapChain::GetFrameStatistics メソッドで初期化します。

IDXGISwapChain::GetFrameStatistics は、フリップ表示モデルを使用するスワップチェーン、または全画面モードで描画するスワップチェーンに対してのみ使用できます。スワップチェーンがフリップ表示モデルを使用することを指定するには、DXGI_SWAP_CHAIN_DESC1 構造体の SwapEffect メンバーに DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL 値を設定します。

PresentCount メンバーと PresentRefreshCount メンバーの値は、フレームがディスプレイ画面に表示された時期に関する情報を示します。これらの値を使用して、グリッチが発生したかどうかを判断できます。SyncRefreshCount メンバーと SyncQPCTime メンバーの値は、オーディオとビデオの同期や非常に精密なアニメーションに使用できるタイミング情報を示します。スワップチェーンが全画面モードで描画する場合、これらの値はコンピューターの起動時を基準とします。スワップチェーンがウィンドウモードで描画する場合、これらの値はスワップチェーンの作成時を基準とします。

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

各言語での定義

#include <windows.h>

// DXGI_FRAME_STATISTICS  (x64 32 / x86 32 バイト)
typedef struct DXGI_FRAME_STATISTICS {
    DWORD PresentCount;
    DWORD PresentRefreshCount;
    DWORD SyncRefreshCount;
    LONGLONG SyncQPCTime;
    LONGLONG SyncGPUTime;
} DXGI_FRAME_STATISTICS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DXGI_FRAME_STATISTICS
{
    public uint PresentCount;
    public uint PresentRefreshCount;
    public uint SyncRefreshCount;
    public long SyncQPCTime;
    public long SyncGPUTime;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DXGI_FRAME_STATISTICS
    Public PresentCount As UInteger
    Public PresentRefreshCount As UInteger
    Public SyncRefreshCount As UInteger
    Public SyncQPCTime As Long
    Public SyncGPUTime As Long
End Structure
import ctypes
from ctypes import wintypes

class DXGI_FRAME_STATISTICS(ctypes.Structure):
    _fields_ = [
        ("PresentCount", wintypes.DWORD),
        ("PresentRefreshCount", wintypes.DWORD),
        ("SyncRefreshCount", wintypes.DWORD),
        ("SyncQPCTime", ctypes.c_longlong),
        ("SyncGPUTime", ctypes.c_longlong),
    ]
#[repr(C)]
pub struct DXGI_FRAME_STATISTICS {
    pub PresentCount: u32,
    pub PresentRefreshCount: u32,
    pub SyncRefreshCount: u32,
    pub SyncQPCTime: i64,
    pub SyncGPUTime: i64,
}
import "golang.org/x/sys/windows"

type DXGI_FRAME_STATISTICS struct {
	PresentCount uint32
	PresentRefreshCount uint32
	SyncRefreshCount uint32
	SyncQPCTime int64
	SyncGPUTime int64
}
type
  DXGI_FRAME_STATISTICS = record
    PresentCount: DWORD;
    PresentRefreshCount: DWORD;
    SyncRefreshCount: DWORD;
    SyncQPCTime: Int64;
    SyncGPUTime: Int64;
  end;
const DXGI_FRAME_STATISTICS = extern struct {
    PresentCount: u32,
    PresentRefreshCount: u32,
    SyncRefreshCount: u32,
    SyncQPCTime: i64,
    SyncGPUTime: i64,
};
type
  DXGI_FRAME_STATISTICS {.bycopy.} = object
    PresentCount: uint32
    PresentRefreshCount: uint32
    SyncRefreshCount: uint32
    SyncQPCTime: int64
    SyncGPUTime: int64
struct DXGI_FRAME_STATISTICS
{
    uint PresentCount;
    uint PresentRefreshCount;
    uint SyncRefreshCount;
    long SyncQPCTime;
    long SyncGPUTime;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DXGI_FRAME_STATISTICS サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; PresentCount : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; PresentRefreshCount : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; SyncRefreshCount : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; SyncQPCTime : LONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; SyncGPUTime : LONGLONG (+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 どちらでも同じコードで動作します。
#defstruct global DXGI_FRAME_STATISTICS
    #field int PresentCount
    #field int PresentRefreshCount
    #field int SyncRefreshCount
    #field int64 SyncQPCTime
    #field int64 SyncGPUTime
#endstruct

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