ホーム › Media.MediaFoundation › D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS
D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| Enable | BOOL | 4 | +0 | +0 | デコード変換を使用するかどうかを示すブール値です。 |
| pReferenceTexture2D | ID3D12Resource* | 8/4 | +8 | +4 | ネイティブなデコード出力を格納する ID3D12Resource へのポインターです。ダウンサンプリングが有効な場合、以降のデコードの送信 (たとえば参照フレームとしての使用) のために、ネイティブのデコード解像度、色空間、および形式による出力が必要になることがあります。 |
| ReferenceSubresource | DWORD | 4 | +16 | +8 | pDecodeTexture2D に指定されたリソースのうち、使用するサブリソースのインデックスです。 |
| OutputColorSpace | DXGI_COLOR_SPACE_TYPE | 4 | +20 | +12 | 出力先の色空間を指定する DXGI_COLOR_SPACE_TYPE 列挙型の値です。 |
| DecodeColorSpace | DXGI_COLOR_SPACE_TYPE | 4 | +24 | +16 | 変換前のデコード済みソースの色空間を指定する DXGI_COLOR_SPACE_TYPE 列挙型の値です。 |
公式ドキュメント
デコード出力の変換に関するパラメーターを指定します。D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS1 も同じ目的で使用されますが、出力の幅と出力の高さのフィールドが追加されています。
解説(Remarks)
スケーリングは、ネイティブのデコードテクスチャのサイズと出力テクスチャのサイズの差によって指定されます。
変換の組み合わせがサポートされているかどうかを判断するには、D3D12_FEATURE_VIDEO_DECODE_CONVERSION_SUPPORT を使用します。
ソースおよび出力先の解像度と形式は、デコードテクスチャのリソースプロパティと、ID3D12VideoCommandList::DecodeFrame で指定される出力バッファーによって伝えられます。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS (x64 32 / x86 20 バイト)
typedef struct D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS {
BOOL Enable;
ID3D12Resource* pReferenceTexture2D;
DWORD ReferenceSubresource;
DXGI_COLOR_SPACE_TYPE OutputColorSpace;
DXGI_COLOR_SPACE_TYPE DecodeColorSpace;
} D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS
{
[MarshalAs(UnmanagedType.Bool)] public bool Enable;
public IntPtr pReferenceTexture2D;
public uint ReferenceSubresource;
public int OutputColorSpace;
public int DecodeColorSpace;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS
<MarshalAs(UnmanagedType.Bool)> Public Enable As Boolean
Public pReferenceTexture2D As IntPtr
Public ReferenceSubresource As UInteger
Public OutputColorSpace As Integer
Public DecodeColorSpace As Integer
End Structureimport ctypes
from ctypes import wintypes
class D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS(ctypes.Structure):
_fields_ = [
("Enable", wintypes.BOOL),
("pReferenceTexture2D", ctypes.c_void_p),
("ReferenceSubresource", wintypes.DWORD),
("OutputColorSpace", ctypes.c_int),
("DecodeColorSpace", ctypes.c_int),
]#[repr(C)]
pub struct D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS {
pub Enable: i32,
pub pReferenceTexture2D: *mut core::ffi::c_void,
pub ReferenceSubresource: u32,
pub OutputColorSpace: i32,
pub DecodeColorSpace: i32,
}import "golang.org/x/sys/windows"
type D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS struct {
Enable int32
pReferenceTexture2D uintptr
ReferenceSubresource uint32
OutputColorSpace int32
DecodeColorSpace int32
}type
D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS = record
Enable: BOOL;
pReferenceTexture2D: Pointer;
ReferenceSubresource: DWORD;
OutputColorSpace: Integer;
DecodeColorSpace: Integer;
end;const D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS = extern struct {
Enable: i32,
pReferenceTexture2D: ?*anyopaque,
ReferenceSubresource: u32,
OutputColorSpace: i32,
DecodeColorSpace: i32,
};type
D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS {.bycopy.} = object
Enable: int32
pReferenceTexture2D: pointer
ReferenceSubresource: uint32
OutputColorSpace: int32
DecodeColorSpace: int32struct D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS
{
int Enable;
void* pReferenceTexture2D;
uint ReferenceSubresource;
int OutputColorSpace;
int DecodeColorSpace;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS サイズ: 20 バイト(x86)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; Enable : BOOL (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pReferenceTexture2D : ID3D12Resource* (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; ReferenceSubresource : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; OutputColorSpace : DXGI_COLOR_SPACE_TYPE (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; DecodeColorSpace : DXGI_COLOR_SPACE_TYPE (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; Enable : BOOL (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pReferenceTexture2D : ID3D12Resource* (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; ReferenceSubresource : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; OutputColorSpace : DXGI_COLOR_SPACE_TYPE (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; DecodeColorSpace : DXGI_COLOR_SPACE_TYPE (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS
#field bool Enable
#field intptr pReferenceTexture2D
#field int ReferenceSubresource
#field int OutputColorSpace
#field int DecodeColorSpace
#endstruct
stdim st, D3D12_VIDEO_DECODE_CONVERSION_ARGUMENTS ; NSTRUCT 変数を確保
st->Enable = 100
mes "Enable=" + st->Enable