ホーム › Media.MediaFoundation › DXVA2_VideoProcessorCaps

DXVA2_VideoProcessorCaps

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 40 バイト / x86: 40 バイト

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

フィールド

型

サイズ

x64

x86

説明

DeviceCaps

DWORD

デバイスの種類を識別します。次の値が定義されています。

値	意味
DXVA2_VPDev_EmulatedDXVA1	DXVA 2.0 のビデオ処理が DXVA 1.0 を使用してエミュレートされます。エミュレートされたデバイスでは重要な処理機能が欠けている場合があり、画質やパフォーマンスが低下することがあります。
DXVA2_VPDev_HardwareDevice	ハードウェアデバイスです。
DXVA2_VPDev_SoftwareDevice	ソフトウェアデバイスです。

InputPool

D3DPOOL

デバイスが使用する Direct3D のメモリプールです。

NumForwardRefSamples

DWORD

デバイスがデインターレースを実行するために必要な前方参照サンプルの数です。bob、プログレッシブスキャン、およびソフトウェアデバイスの場合、この値は 0 です。

NumBackwardRefSamples

DWORD

+12

デバイスがデインターレースを実行するために必要な後方参照サンプルの数です。bob、プログレッシブスキャン、およびソフトウェアデバイスの場合、この値は 0 です。

Reserved

DWORD

+16

予約済みです。0 でなければなりません。

DeinterlaceTechnology

DWORD

+20

デバイスが使用するデインターレース手法を識別します。この値は、次のフラグのうち 1 つ以上のビット単位の OR です。

値	意味
DXVA2_DeinterlaceTech_Unknown	アルゴリズムが不明、または独自仕様です。
DXVA2_DeinterlaceTech_BOBLineReplicate	欠落している行の上または下の行を繰り返すことで、欠落した行を生成するアルゴリズムです。この方式はギザギザの画像を生じるため、推奨されません。
DXVA2_DeinterlaceTech_BOBVerticalStretch	2 つの行を平均することで、欠落した行を生成するアルゴリズムです。結果として得られる画像が上下に揺れないように、垂直方向のわずかな調整が行われます。
DXVA2_DeinterlaceTech_BOBVerticalStretch4Tap	4 つの行にわたって [−1, 9, 9, −1]/16 フィルターを適用することで、欠落した行を生成するアルゴリズムです。結果として得られる画像が上下に揺れないように、垂直方向のわずかな調整が行われます。
DXVA2_DeinterlaceTech_MedianFiltering	メディアンフィルター処理を使用して、欠落した行のピクセルを再生成するアルゴリズムです。
DXVA2_DeinterlaceTech_EdgeFiltering	エッジフィルターを使用して、欠落した行を生成するアルゴリズムです。この処理では、空間方向フィルターを適用して画像内容のエッジの向きを判定します。欠落したピクセルは、検出されたエッジを横切る方向ではなく、エッジに沿ってフィルター処理することで生成されます。
DXVA2_DeinterlaceTech_FieldAdaptive	動きの量に応じて、フィールド単位で空間補間と時間補間を切り替えて使用するアルゴリズムです。
DXVA2_DeinterlaceTech_PixelAdaptive	動きの量に応じて、ピクセル単位で空間補間と時間補間を切り替えて使用するアルゴリズムです。
DXVA2_DeinterlaceTech_MotionVectorSteered	一連のビデオフィールド内のオブジェクトを識別するアルゴリズムです。欠落したピクセルを再生成する前に、シーン内の個々のオブジェクトの移動軸を時間軸と平行になるように整列します。
DXVA2_DeinterlaceTech_InverseTelecine	デバイスは、テレシネで使用される 3:2 プルダウン処理を元に戻すことができます。

ProcAmpControlCaps

DWORD

+24

使用可能なビデオプロセッサ (ProcAmp) の操作を指定します。この値は、ProcAmp Settings 定数のビット単位の OR です。

VideoProcessorOperations

DWORD

+28

デバイスが IDirectXVideoProcessor::VideoProcessBlt 操作と同時に実行できる操作を指定します。この値は、次のフラグのビット単位の OR です。

値	意味
DXVA2_VideoProcess_YUV2RGB	デバイスは、各 RGB 成分について少なくとも 8 ビットの精度で、ビデオを YUV 色空間から RGB 色空間に変換できます。
DXVA2_VideoProcess_StretchX	デバイスは、ビデオを水平方向に拡大または縮小できます。この機能がある場合、デインターレースと同時にアスペクト比の補正を実行できます。
DXVA2_VideoProcess_StretchY	デバイスは、ビデオを垂直方向に拡大または縮小できます。この機能がある場合、画像のサイズ変更とアスペクト比の補正を同時に実行できます。
DXVA2_VideoProcess_AlphaBlend	デバイスは、ビデオをアルファブレンドできます。
DXVA2_VideoProcess_SubRects	デバイスは、ビデオフレームの部分矩形に対して処理を実行できます。この機能がある場合、以降の処理を行う前にソース画像をトリミングできます。
DXVA2_VideoProcess_SubStreams	デバイスは、プライマリビデオストリームに加えてサブストリームを受け付け、それらを合成できます。
DXVA2_VideoProcess_SubStreamsExtended	デバイスは、ビデオのデインターレースとサブストリームの合成を行うのと同時に、プライマリビデオストリームおよびサブストリームに対して色調整を実行できます。出力先の色空間は、DXVA2_VideoProcessBltParams 構造体の DestFormat メンバーで定義されます。各ストリームのソースの色空間は、DXVA2_VideoSample 構造体の SampleFormat メンバーで定義されます。
DXVA2_VideoProcess_YUV2RGBExtended	デバイスは、デインターレースおよび合成されたピクセルを出力先サーフェスに書き込む際に、ビデオを YUV 色空間から RGB 色空間に変換できます。 RGB の出力先サーフェスには、オフスクリーンサーフェス、テクスチャ、Direct3D レンダーターゲット、またはテクスチャとレンダーターゲットを兼ねたサーフェスを使用できます。RGB の出力先サーフェスは、各カラーチャネルに少なくとも 8 ビットを使用しなければなりません。
DXVA2_VideoProcess_AlphaBlendExtended	デバイスは、デインターレースおよび合成されたピクセルを出力先サーフェスに書き込む際に、出力先サーフェスとのアルファブレンド操作を実行できます。
DXVA2_VideoProcess_Constriction	デバイスは、DXVA2_VideoProcessBltParams 構造体の ConstrictionSize メンバーで指定されたとおりに、出力フレームをダウンサンプリングできます。
DXVA2_VideoProcess_NoiseFilter	デバイスは、ノイズフィルター処理を実行できます。
DXVA2_VideoProcess_DetailFilter	デバイスは、ディテールフィルター処理を実行できます。
DXVA2_VideoProcess_PlanarAlpha	デバイスは、ビデオストリームとサブストリームを合成する際に、ビデオストリーム全体に対して一定のアルファブレンドを実行できます。
DXVA2_VideoProcess_LinearScaling	デバイスは、非線形のガンマ空間で処理するのではなく、正確な線形 RGB スケーリングを実行できます。
DXVA2_VideoProcess_GammaCompensated	デバイスは、非線形のガンマ空間でスケーリングを実行した際に生じるアーティファクトを補正するように画像を補正できます。
DXVA2_VideoProcess_MaintainsOriginalFieldData	スケーリングも適用される場合を除き、デインターレースアルゴリズムはインターレースフィールドピクチャの元のフィールドラインを保持します。たとえば、bob やメディアンフィルター処理などのデインターレースアルゴリズムでは、デバイスは元のフィールドを 1 行おきのスキャンラインにコピーし、その後フィルターを適用して欠落したスキャンラインを再構成します。そのため、補間されたスキャンラインを破棄することで元のフィールドを復元できます。ただし、画像が垂直方向にスケーリングされた場合は、元のフィールドラインを復元できません。画像が (垂直方向ではなく) 水平方向にスケーリングされた場合、結果として得られるフィールドラインは、元のフィールドピクチャをスケーリングしたものと等価になります。(言い換えると、補間されたスキャンラインを破棄すると、デインターレースを行わずに元のピクチャを引き伸ばした場合と同じ結果が得られます。)

NoiseFilterTechnology

DWORD

+32

サポートされるノイズフィルターを指定します。この値は、次のフラグのビット単位の OR です。

値	意味
DXVA2_NoiseFilterTech_Unsupported	ノイズフィルター処理はサポートされていません。
DXVA2_NoiseFilterTech_Unknown	不明または独自仕様のフィルターです。
DXVA2_NoiseFilterTech_Median	メディアンフィルターです。
DXVA2_NoiseFilterTech_Temporal	時間方向フィルターです。
DXVA2_NoiseFilterTech_BlockNoise	ブロックノイズフィルターです。
DXVA2_NoiseFilterTech_MosquitoNoise	モスキートノイズフィルターです。

DetailFilterTechnology

DWORD

+36

サポートされるディテールフィルターを指定します。この値は、次のフラグのビット単位の OR です。

値	意味
DXVA2_DetailFilterTech_Unsupported	ディテールフィルター処理はサポートされていません。
DXVA2_DetailFilterTech_Unknown	不明または独自仕様のフィルターです。
DXVA2_DetailFilterTech_Edge	エッジフィルターです。
DXVA2_DetailFilterTech_Sharpening	シャープフィルターです。

公式ドキュメント

DirectX Video Acceleration (DVXA) ビデオプロセッサモードの機能を記述します。

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

各言語での定義

#include <windows.h>

// DXVA2_VideoProcessorCaps  (x64 40 / x86 40 バイト)
typedef struct DXVA2_VideoProcessorCaps {
    DWORD DeviceCaps;
    D3DPOOL InputPool;
    DWORD NumForwardRefSamples;
    DWORD NumBackwardRefSamples;
    DWORD Reserved;
    DWORD DeinterlaceTechnology;
    DWORD ProcAmpControlCaps;
    DWORD VideoProcessorOperations;
    DWORD NoiseFilterTechnology;
    DWORD DetailFilterTechnology;
} DXVA2_VideoProcessorCaps;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DXVA2_VideoProcessorCaps
{
    public uint DeviceCaps;
    public int InputPool;
    public uint NumForwardRefSamples;
    public uint NumBackwardRefSamples;
    public uint Reserved;
    public uint DeinterlaceTechnology;
    public uint ProcAmpControlCaps;
    public uint VideoProcessorOperations;
    public uint NoiseFilterTechnology;
    public uint DetailFilterTechnology;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DXVA2_VideoProcessorCaps
    Public DeviceCaps As UInteger
    Public InputPool As Integer
    Public NumForwardRefSamples As UInteger
    Public NumBackwardRefSamples As UInteger
    Public Reserved As UInteger
    Public DeinterlaceTechnology As UInteger
    Public ProcAmpControlCaps As UInteger
    Public VideoProcessorOperations As UInteger
    Public NoiseFilterTechnology As UInteger
    Public DetailFilterTechnology As UInteger
End Structure

import ctypes
from ctypes import wintypes

class DXVA2_VideoProcessorCaps(ctypes.Structure):
    _fields_ = [
        ("DeviceCaps", wintypes.DWORD),
        ("InputPool", ctypes.c_int),
        ("NumForwardRefSamples", wintypes.DWORD),
        ("NumBackwardRefSamples", wintypes.DWORD),
        ("Reserved", wintypes.DWORD),
        ("DeinterlaceTechnology", wintypes.DWORD),
        ("ProcAmpControlCaps", wintypes.DWORD),
        ("VideoProcessorOperations", wintypes.DWORD),
        ("NoiseFilterTechnology", wintypes.DWORD),
        ("DetailFilterTechnology", wintypes.DWORD),
    ]

#[repr(C)]
pub struct DXVA2_VideoProcessorCaps {
    pub DeviceCaps: u32,
    pub InputPool: i32,
    pub NumForwardRefSamples: u32,
    pub NumBackwardRefSamples: u32,
    pub Reserved: u32,
    pub DeinterlaceTechnology: u32,
    pub ProcAmpControlCaps: u32,
    pub VideoProcessorOperations: u32,
    pub NoiseFilterTechnology: u32,
    pub DetailFilterTechnology: u32,
}

import "golang.org/x/sys/windows"

type DXVA2_VideoProcessorCaps struct {
	DeviceCaps uint32
	InputPool int32
	NumForwardRefSamples uint32
	NumBackwardRefSamples uint32
	Reserved uint32
	DeinterlaceTechnology uint32
	ProcAmpControlCaps uint32
	VideoProcessorOperations uint32
	NoiseFilterTechnology uint32
	DetailFilterTechnology uint32
}

type
  DXVA2_VideoProcessorCaps = record
    DeviceCaps: DWORD;
    InputPool: Integer;
    NumForwardRefSamples: DWORD;
    NumBackwardRefSamples: DWORD;
    Reserved: DWORD;
    DeinterlaceTechnology: DWORD;
    ProcAmpControlCaps: DWORD;
    VideoProcessorOperations: DWORD;
    NoiseFilterTechnology: DWORD;
    DetailFilterTechnology: DWORD;
  end;

const DXVA2_VideoProcessorCaps = extern struct {
    DeviceCaps: u32,
    InputPool: i32,
    NumForwardRefSamples: u32,
    NumBackwardRefSamples: u32,
    Reserved: u32,
    DeinterlaceTechnology: u32,
    ProcAmpControlCaps: u32,
    VideoProcessorOperations: u32,
    NoiseFilterTechnology: u32,
    DetailFilterTechnology: u32,
};

type
  DXVA2_VideoProcessorCaps {.bycopy.} = object
    DeviceCaps: uint32
    InputPool: int32
    NumForwardRefSamples: uint32
    NumBackwardRefSamples: uint32
    Reserved: uint32
    DeinterlaceTechnology: uint32
    ProcAmpControlCaps: uint32
    VideoProcessorOperations: uint32
    NoiseFilterTechnology: uint32
    DetailFilterTechnology: uint32

struct DXVA2_VideoProcessorCaps
{
    uint DeviceCaps;
    int InputPool;
    uint NumForwardRefSamples;
    uint NumBackwardRefSamples;
    uint Reserved;
    uint DeinterlaceTechnology;
    uint ProcAmpControlCaps;
    uint VideoProcessorOperations;
    uint NoiseFilterTechnology;
    uint DetailFilterTechnology;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DXVA2_VideoProcessorCaps サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; DeviceCaps : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; InputPool : D3DPOOL (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; NumForwardRefSamples : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; NumBackwardRefSamples : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Reserved : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DeinterlaceTechnology : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ProcAmpControlCaps : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; VideoProcessorOperations : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; NoiseFilterTechnology : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; DetailFilterTechnology : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DXVA2_VideoProcessorCaps
    #field int DeviceCaps
    #field int InputPool
    #field int NumForwardRefSamples
    #field int NumBackwardRefSamples
    #field int Reserved
    #field int DeinterlaceTechnology
    #field int ProcAmpControlCaps
    #field int VideoProcessorOperations
    #field int NoiseFilterTechnology
    #field int DetailFilterTechnology
#endstruct

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

DXVA2_VideoProcessorCaps

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義