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

D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT

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

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

フィールド

フィールドサイズx64x86説明
NodeIndexDWORD4+0+0単一 GPU で動作する場合は、これを 0 に設定します。複数の GPU ノードがある場合は、コマンドキューを適用するノード (デバイスの物理アダプター) を識別するビットを設定します。マスクの各ビットが 1 つのノードに対応します。設定できるビットは 1 つだけです。
ConfigurationD3D12_VIDEO_DECODE_CONFIGURATION24+4+4ソースストリームのデコードプロファイル、ビットストリームの暗号化、およびインターレースの種類を指定する D3D12_VIDEO_DECODE_CONFIGURATION 構造体です。
WidthDWORD4+28+28ソースストリームのデコード幅です。
HeightDWORD4+32+32ソースストリームのデコード高さです。
DecodeFormatDXGI_FORMAT4+36+36デコード形式として使用する DXGI_FORMAT です。デコーダーの変換が指定されていない場合、この形式が出力形式になります。
FrameRateDXGI_RATIONAL8+40+40ビデオ形式のフレームレートです。値が 0 の場合、フレームレートは不明であることを意味します。
BitRateDWORD4+48+48圧縮されたビデオストリームの、1 秒あたりの平均ビット数で表されるデータ圧縮率です。この情報は、ビデオをリアルタイムでデコードできるかどうかをドライバーが判断するために使用されます。値が 0 の場合、ビットレートは不明であることを意味します。
SupportFlagsD3D12_VIDEO_DECODE_SUPPORT_FLAGS4+52+52ビデオデコードのサポート状況を示す、D3D12_VIDEO_DECODE_SUPPORT_FLAGS 列挙型の値の組み合わせです。この値は ID3D12Device::CheckFeatureSupport の呼び出しによって設定されます。
ConfigurationFlagsD3D12_VIDEO_DECODE_CONFIGURATION_FLAGS4+56+56ビデオデコードの構成を記述する、D3D12_VIDEO_DECODE_CONFIGURATION_FLAGS 列挙型の値の組み合わせです。この値は ID3D12Device::CheckFeatureSupport の呼び出しによって設定されます。
DecodeTierD3D12_VIDEO_DECODE_TIER4+60+60ハードウェアビデオデコーダーのデコードティアを指定する、D3D12_VIDEO_DECODE_TIER 列挙型のメンバーです。

公式ドキュメント

指定された機能が D3D12_FEATURE_VIDEO_DECODE_SUPPORT の場合に、ID3D12VideoDevice::CheckFeatureSupport の呼び出しに対してデータを提供します。ビデオデコードのサポート情報を取得します。

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

各言語での定義

#include <windows.h>

// D3D12_VIDEO_DECODE_CONFIGURATION  (x64 24 / x86 24 バイト)
typedef struct D3D12_VIDEO_DECODE_CONFIGURATION {
    GUID DecodeProfile;
    D3D12_BITSTREAM_ENCRYPTION_TYPE BitstreamEncryption;
    D3D12_VIDEO_FRAME_CODED_INTERLACE_TYPE InterlaceType;
} D3D12_VIDEO_DECODE_CONFIGURATION;

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

// D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT  (x64 64 / x86 64 バイト)
typedef struct D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT {
    DWORD NodeIndex;
    D3D12_VIDEO_DECODE_CONFIGURATION Configuration;
    DWORD Width;
    DWORD Height;
    DXGI_FORMAT DecodeFormat;
    DXGI_RATIONAL FrameRate;
    DWORD BitRate;
    D3D12_VIDEO_DECODE_SUPPORT_FLAGS SupportFlags;
    D3D12_VIDEO_DECODE_CONFIGURATION_FLAGS ConfigurationFlags;
    D3D12_VIDEO_DECODE_TIER DecodeTier;
} D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_VIDEO_DECODE_CONFIGURATION
{
    public Guid DecodeProfile;
    public int BitstreamEncryption;
    public int InterlaceType;
}

[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_FEATURE_DATA_VIDEO_DECODE_SUPPORT
{
    public uint NodeIndex;
    public D3D12_VIDEO_DECODE_CONFIGURATION Configuration;
    public uint Width;
    public uint Height;
    public int DecodeFormat;
    public DXGI_RATIONAL FrameRate;
    public uint BitRate;
    public int SupportFlags;
    public int ConfigurationFlags;
    public int DecodeTier;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_VIDEO_DECODE_CONFIGURATION
    Public DecodeProfile As Guid
    Public BitstreamEncryption As Integer
    Public InterlaceType As Integer
End Structure

<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_FEATURE_DATA_VIDEO_DECODE_SUPPORT
    Public NodeIndex As UInteger
    Public Configuration As D3D12_VIDEO_DECODE_CONFIGURATION
    Public Width As UInteger
    Public Height As UInteger
    Public DecodeFormat As Integer
    Public FrameRate As DXGI_RATIONAL
    Public BitRate As UInteger
    Public SupportFlags As Integer
    Public ConfigurationFlags As Integer
    Public DecodeTier As Integer
End Structure
import ctypes
from ctypes import wintypes

class D3D12_VIDEO_DECODE_CONFIGURATION(ctypes.Structure):
    _fields_ = [
        ("DecodeProfile", GUID),
        ("BitstreamEncryption", ctypes.c_int),
        ("InterlaceType", ctypes.c_int),
    ]

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

class D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT(ctypes.Structure):
    _fields_ = [
        ("NodeIndex", wintypes.DWORD),
        ("Configuration", D3D12_VIDEO_DECODE_CONFIGURATION),
        ("Width", wintypes.DWORD),
        ("Height", wintypes.DWORD),
        ("DecodeFormat", ctypes.c_int),
        ("FrameRate", DXGI_RATIONAL),
        ("BitRate", wintypes.DWORD),
        ("SupportFlags", ctypes.c_int),
        ("ConfigurationFlags", ctypes.c_int),
        ("DecodeTier", ctypes.c_int),
    ]
#[repr(C)]
pub struct D3D12_VIDEO_DECODE_CONFIGURATION {
    pub DecodeProfile: GUID,
    pub BitstreamEncryption: i32,
    pub InterlaceType: i32,
}

#[repr(C)]
pub struct DXGI_RATIONAL {
    pub Numerator: u32,
    pub Denominator: u32,
}

#[repr(C)]
pub struct D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT {
    pub NodeIndex: u32,
    pub Configuration: D3D12_VIDEO_DECODE_CONFIGURATION,
    pub Width: u32,
    pub Height: u32,
    pub DecodeFormat: i32,
    pub FrameRate: DXGI_RATIONAL,
    pub BitRate: u32,
    pub SupportFlags: i32,
    pub ConfigurationFlags: i32,
    pub DecodeTier: i32,
}
import "golang.org/x/sys/windows"

type D3D12_VIDEO_DECODE_CONFIGURATION struct {
	DecodeProfile windows.GUID
	BitstreamEncryption int32
	InterlaceType int32
}

type DXGI_RATIONAL struct {
	Numerator uint32
	Denominator uint32
}

type D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT struct {
	NodeIndex uint32
	Configuration D3D12_VIDEO_DECODE_CONFIGURATION
	Width uint32
	Height uint32
	DecodeFormat int32
	FrameRate DXGI_RATIONAL
	BitRate uint32
	SupportFlags int32
	ConfigurationFlags int32
	DecodeTier int32
}
type
  D3D12_VIDEO_DECODE_CONFIGURATION = record
    DecodeProfile: TGUID;
    BitstreamEncryption: Integer;
    InterlaceType: Integer;
  end;

  DXGI_RATIONAL = record
    Numerator: DWORD;
    Denominator: DWORD;
  end;

  D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT = record
    NodeIndex: DWORD;
    Configuration: D3D12_VIDEO_DECODE_CONFIGURATION;
    Width: DWORD;
    Height: DWORD;
    DecodeFormat: Integer;
    FrameRate: DXGI_RATIONAL;
    BitRate: DWORD;
    SupportFlags: Integer;
    ConfigurationFlags: Integer;
    DecodeTier: Integer;
  end;
const D3D12_VIDEO_DECODE_CONFIGURATION = extern struct {
    DecodeProfile: GUID,
    BitstreamEncryption: i32,
    InterlaceType: i32,
};

const DXGI_RATIONAL = extern struct {
    Numerator: u32,
    Denominator: u32,
};

const D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT = extern struct {
    NodeIndex: u32,
    Configuration: D3D12_VIDEO_DECODE_CONFIGURATION,
    Width: u32,
    Height: u32,
    DecodeFormat: i32,
    FrameRate: DXGI_RATIONAL,
    BitRate: u32,
    SupportFlags: i32,
    ConfigurationFlags: i32,
    DecodeTier: i32,
};
type
  D3D12_VIDEO_DECODE_CONFIGURATION {.bycopy.} = object
    DecodeProfile: GUID
    BitstreamEncryption: int32
    InterlaceType: int32

  DXGI_RATIONAL {.bycopy.} = object
    Numerator: uint32
    Denominator: uint32

  D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT {.bycopy.} = object
    NodeIndex: uint32
    Configuration: D3D12_VIDEO_DECODE_CONFIGURATION
    Width: uint32
    Height: uint32
    DecodeFormat: int32
    FrameRate: DXGI_RATIONAL
    BitRate: uint32
    SupportFlags: int32
    ConfigurationFlags: int32
    DecodeTier: int32
struct D3D12_VIDEO_DECODE_CONFIGURATION
{
    GUID DecodeProfile;
    int BitstreamEncryption;
    int InterlaceType;
}

struct DXGI_RATIONAL
{
    uint Numerator;
    uint Denominator;
}

struct D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT
{
    uint NodeIndex;
    D3D12_VIDEO_DECODE_CONFIGURATION Configuration;
    uint Width;
    uint Height;
    int DecodeFormat;
    DXGI_RATIONAL FrameRate;
    uint BitRate;
    int SupportFlags;
    int ConfigurationFlags;
    int DecodeTier;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; NodeIndex : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Configuration : D3D12_VIDEO_DECODE_CONFIGURATION (+4, 24byte)  varptr(st)+4 を基点に操作(24byte:入れ子/配列)
; Width : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; Height : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; DecodeFormat : DXGI_FORMAT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; FrameRate : DXGI_RATIONAL (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; BitRate : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; SupportFlags : D3D12_VIDEO_DECODE_SUPPORT_FLAGS (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ConfigurationFlags : D3D12_VIDEO_DECODE_CONFIGURATION_FLAGS (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; DecodeTier : D3D12_VIDEO_DECODE_TIER (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global D3D12_VIDEO_DECODE_CONFIGURATION
    #field GUID DecodeProfile
    #field int BitstreamEncryption
    #field int InterlaceType
#endstruct

#defstruct global DXGI_RATIONAL
    #field int Numerator
    #field int Denominator
#endstruct

#defstruct global D3D12_FEATURE_DATA_VIDEO_DECODE_SUPPORT
    #field int NodeIndex
    #field D3D12_VIDEO_DECODE_CONFIGURATION Configuration
    #field int Width
    #field int Height
    #field int DecodeFormat
    #field DXGI_RATIONAL FrameRate
    #field int BitRate
    #field int SupportFlags
    #field int ConfigurationFlags
    #field int DecodeTier
#endstruct

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