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

D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR

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

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

フィールド

フィールド型サイズx64x86説明
InitialQPDWORD4+0+0D3D12_VIDEO_ENCODER_RATE_CONTROL_FLAG_ENABLE_INITIAL_QP が有効な場合に、レート制御アルゴリズムで使用される初期 QP を指定できます。
MinQPDWORD4+4+4D3D12_VIDEO_ENCODER_RATE_CONTROL_FLAG_ENABLE_QP_RANGE が有効な場合に、レート制御アルゴリズムの QP の範囲を制限します。
MaxQPDWORD4+8+8D3D12_VIDEO_ENCODER_RATE_CONTROL_FLAG_ENABLE_QP_RANGE が有効な場合に、レート制御アルゴリズムの QP の範囲を制限します。
MaxFrameBitSizeULONGLONG8+16+16符号化する各フレームの最大サイズ (ビット単位)。D3D12_VIDEO_ENCODER_RATE_CONTROL_FLAG_ENABLE_MAX_FRAME_SIZE が有効な場合に、レート制御アルゴリズムで各フレームの最大サイズを制限します。
TargetBitRateULONGLONG8+24+24使用する固定ビットレートをビット/秒単位で指定します。
VBVCapacityULONGLONG8+32+32D3D12_VIDEO_ENCODER_SUPPORT_FLAG_RATE_CONTROL_VBV_SIZE_CONFIG_AVAILABLE が有効な場合に、レート制御アルゴリズムで使用される Video Buffer Verifier の容量をビット単位で指定します。
InitialVBVFullnessULONGLONG8+40+40D3D12_VIDEO_ENCODER_SUPPORT_FLAG_RATE_CONTROL_VBV_SIZE_CONFIG_AVAILABLE が有効な場合に、レート制御アルゴリズムで使用される Video Buffer Verifier の初期充填量をビット単位で指定します。

公式ドキュメント

固定ビットレート モード用のレート制御構造体の定義を表します。

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

各言語での定義

#include <windows.h>

// D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR  (x64 48 / x86 48 バイト)
typedef struct D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR {
    DWORD InitialQP;
    DWORD MinQP;
    DWORD MaxQP;
    ULONGLONG MaxFrameBitSize;
    ULONGLONG TargetBitRate;
    ULONGLONG VBVCapacity;
    ULONGLONG InitialVBVFullness;
} D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR
{
    public uint InitialQP;
    public uint MinQP;
    public uint MaxQP;
    public ulong MaxFrameBitSize;
    public ulong TargetBitRate;
    public ulong VBVCapacity;
    public ulong InitialVBVFullness;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR
    Public InitialQP As UInteger
    Public MinQP As UInteger
    Public MaxQP As UInteger
    Public MaxFrameBitSize As ULong
    Public TargetBitRate As ULong
    Public VBVCapacity As ULong
    Public InitialVBVFullness As ULong
End Structure
import ctypes
from ctypes import wintypes

class D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR(ctypes.Structure):
    _fields_ = [
        ("InitialQP", wintypes.DWORD),
        ("MinQP", wintypes.DWORD),
        ("MaxQP", wintypes.DWORD),
        ("MaxFrameBitSize", ctypes.c_ulonglong),
        ("TargetBitRate", ctypes.c_ulonglong),
        ("VBVCapacity", ctypes.c_ulonglong),
        ("InitialVBVFullness", ctypes.c_ulonglong),
    ]
#[repr(C)]
pub struct D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR {
    pub InitialQP: u32,
    pub MinQP: u32,
    pub MaxQP: u32,
    pub MaxFrameBitSize: u64,
    pub TargetBitRate: u64,
    pub VBVCapacity: u64,
    pub InitialVBVFullness: u64,
}
import "golang.org/x/sys/windows"

type D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR struct {
	InitialQP uint32
	MinQP uint32
	MaxQP uint32
	MaxFrameBitSize uint64
	TargetBitRate uint64
	VBVCapacity uint64
	InitialVBVFullness uint64
}
type
  D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR = record
    InitialQP: DWORD;
    MinQP: DWORD;
    MaxQP: DWORD;
    MaxFrameBitSize: UInt64;
    TargetBitRate: UInt64;
    VBVCapacity: UInt64;
    InitialVBVFullness: UInt64;
  end;
const D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR = extern struct {
    InitialQP: u32,
    MinQP: u32,
    MaxQP: u32,
    MaxFrameBitSize: u64,
    TargetBitRate: u64,
    VBVCapacity: u64,
    InitialVBVFullness: u64,
};
type
  D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR {.bycopy.} = object
    InitialQP: uint32
    MinQP: uint32
    MaxQP: uint32
    MaxFrameBitSize: uint64
    TargetBitRate: uint64
    VBVCapacity: uint64
    InitialVBVFullness: uint64
struct D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR
{
    uint InitialQP;
    uint MinQP;
    uint MaxQP;
    ulong MaxFrameBitSize;
    ulong TargetBitRate;
    ulong VBVCapacity;
    ulong InitialVBVFullness;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; InitialQP : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; MinQP : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; MaxQP : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; MaxFrameBitSize : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; TargetBitRate : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; VBVCapacity : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; InitialVBVFullness : ULONGLONG (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D12_VIDEO_ENCODER_RATE_CONTROL_CBR
    #field int InitialQP
    #field int MinQP
    #field int MaxQP
    #field int64 MaxFrameBitSize
    #field int64 TargetBitRate
    #field int64 VBVCapacity
    #field int64 InitialVBVFullness
#endstruct

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