Win32 API 日本語リファレンス
ホーム › Media.MediaFoundation › D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS

D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS

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

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

フィールド

フィールド型サイズx64x86説明
StatusULONGLONG8+0+0ビデオデコードの状態を示す D3D12_VIDEO_DECODE_STATUS 列挙型のメンバーです。
NumMacroblocksAffectedULONGLONG8+8+8Status が 0 以外の場合、このメンバーには、報告された問題によって悪影響を受けたデコード済みフレーム内のスーパーブロック数についてのアクセラレーターによる推定値が格納されます。アクセラレーターが推定値を提供しない場合、値は D3D12_VIDEO_DECODE_MACROBLOCKS_AFFECTED_UNKNOWN (0xFFFFFFFFFFFFFFFF) になります。
FrameRateDXGI_RATIONAL8+16+16デコードのフレームレートです。
BitRateDWORD4+24+24

返される Status が D3D12_VIDEO_DECODE_STATUS_RATE_EXCEEDED の場合、このフィールドは成功するであろうビットレートを報告します。この値は、デコーダーを再作成して再試行するために使用できます。ここでの値が 0 であることは有効であり、最悪の場合のビットレートを想定すべきであることを示します。

それ以外のすべての Status の値では、BitRate は 0 に設定されます。

公式ドキュメント

ID3D12VideoDecodeCommandList::EndQuery の呼び出しによって実行されたビデオデコード統計クエリのデータを表します。

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

各言語での定義

#include <windows.h>

// DXGI_RATIONAL  (x64 8 / x86 8 バイト)
typedef struct DXGI_RATIONAL {
    DWORD Numerator;
    DWORD Denominator;
} DXGI_RATIONAL;

// D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS  (x64 32 / x86 32 バイト)
typedef struct D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS {
    ULONGLONG Status;
    ULONGLONG NumMacroblocksAffected;
    DXGI_RATIONAL FrameRate;
    DWORD BitRate;
} D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DXGI_RATIONAL
{
    public uint Numerator;
    public uint Denominator;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS
{
    public ulong Status;
    public ulong NumMacroblocksAffected;
    public DXGI_RATIONAL FrameRate;
    public uint BitRate;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DXGI_RATIONAL
    Public Numerator As UInteger
    Public Denominator As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS
    Public Status As ULong
    Public NumMacroblocksAffected As ULong
    Public FrameRate As DXGI_RATIONAL
    Public BitRate As UInteger
End Structure
import ctypes
from ctypes import wintypes

class DXGI_RATIONAL(ctypes.Structure):
    _fields_ = [
        ("Numerator", wintypes.DWORD),
        ("Denominator", wintypes.DWORD),
    ]

class D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS(ctypes.Structure):
    _fields_ = [
        ("Status", ctypes.c_ulonglong),
        ("NumMacroblocksAffected", ctypes.c_ulonglong),
        ("FrameRate", DXGI_RATIONAL),
        ("BitRate", wintypes.DWORD),
    ]
#[repr(C)]
pub struct DXGI_RATIONAL {
    pub Numerator: u32,
    pub Denominator: u32,
}

#[repr(C)]
pub struct D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS {
    pub Status: u64,
    pub NumMacroblocksAffected: u64,
    pub FrameRate: DXGI_RATIONAL,
    pub BitRate: u32,
}
import "golang.org/x/sys/windows"

type DXGI_RATIONAL struct {
	Numerator uint32
	Denominator uint32
}

type D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS struct {
	Status uint64
	NumMacroblocksAffected uint64
	FrameRate DXGI_RATIONAL
	BitRate uint32
}
type
  DXGI_RATIONAL = record
    Numerator: DWORD;
    Denominator: DWORD;
  end;

  D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS = record
    Status: UInt64;
    NumMacroblocksAffected: UInt64;
    FrameRate: DXGI_RATIONAL;
    BitRate: DWORD;
  end;
const DXGI_RATIONAL = extern struct {
    Numerator: u32,
    Denominator: u32,
};

const D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS = extern struct {
    Status: u64,
    NumMacroblocksAffected: u64,
    FrameRate: DXGI_RATIONAL,
    BitRate: u32,
};
type
  DXGI_RATIONAL {.bycopy.} = object
    Numerator: uint32
    Denominator: uint32

  D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS {.bycopy.} = object
    Status: uint64
    NumMacroblocksAffected: uint64
    FrameRate: DXGI_RATIONAL
    BitRate: uint32
struct DXGI_RATIONAL
{
    uint Numerator;
    uint Denominator;
}

struct D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS
{
    ulong Status;
    ulong NumMacroblocksAffected;
    DXGI_RATIONAL FrameRate;
    uint BitRate;
}

HSP用 定義

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

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

#defstruct global D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS
    #field int64 Status
    #field int64 NumMacroblocksAffected
    #field DXGI_RATIONAL FrameRate
    #field int BitRate
#endstruct

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