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

DXVA2_DecodeBufferDesc

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

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

フィールド

フィールド型サイズx64x86説明
CompressedBufferTypeDWORD4+0+0

アクセラレーターに渡されるバッファーの種類を識別します。次のいずれかの値でなければなりません。

値 意味
DXVA2_PictureParametersBufferType
 ピクチャーのデコードパラメーターバッファーです。
DXVA2_MacroBlockControlBufferType
 マクロブロック制御コマンドバッファーです。
DXVA2_ResidualDifferenceBufferType
 残差差分ブロックデータバッファーです。
DXVA2_DeblockingControlBufferType
 デブロッキングフィルター制御コマンドバッファーです。
DXVA2_InverseQuantizationMatrixBufferType
 逆量子化行列バッファーです。
DXVA2_SliceControlBufferType
 スライス制御バッファーです。
DXVA2_BitStreamDateBufferType
 ビットストリームデータバッファーです。
DXVA2_MotionVectorBuffer
 動きベクトルバッファーです。
DXVA2_FilmGrainBuffer
 フィルムグレイン合成データバッファーです。
BufferIndexDWORD4+4+4予約済みです。0 に設定します。
DataOffsetDWORD4+8+8バッファーの先頭から該当データまでのオフセットをバイト単位で指定します。現在のところ、この値は 0 でなければなりません。
DataSizeDWORD4+12+12バッファー内の該当データの量をバイト単位で指定します。バッファー内の内容の最終バイトの位置は DataOffset + DataSize − 1 です。
FirstMBaddressDWORD4+16+16バッファー内の最初のマクロブロックのマクロブロックアドレスを指定します。マクロブロックアドレスはラスタースキャン順で与えられます。
NumMBsInBufferDWORD4+20+20バッファー内のデータのマクロブロック数を指定します。この数にはスキップされたマクロブロックも含まれます。データバッファーの種類が次のいずれかである場合、この値は 0 でなければなりません: ピクチャーデコードパラメーター、逆量子化行列、AYUV、IA44/AI44、DPXD、Highlight、DCCMD。
WidthDWORD4+24+24予約済みです。0 に設定します。
HeightDWORD4+28+28予約済みです。0 に設定します。
StrideDWORD4+32+32予約済みです。0 に設定します。
ReservedBitsDWORD4+36+36予約済みです。0 に設定します。
pvPVPStatevoid*8/4+40+40暗号化されたデータの初期化ベクトル (IV) を格納するバイト配列へのポインターです。デコードバッファーに暗号化されたデータが含まれていない場合は、このメンバーを NULL に設定します。 デコードバッファーに暗号化されたデータが含まれている場合、pvPVPState の内容は暗号化の種類によって異なります。D3DCRYPTOTYPE_AES128_CTR の場合、pvPVPState メンバーは DXVA2_AES_CTR_IV 構造体を指します。

公式ドキュメント

デコーダーから DirectX Video Acceleration (DXVA) デバイスへ送信されるバッファーを記述します。

解説(Remarks)

この構造体は DXVA 1 の DXVA_BufferDescription 構造体に厳密に対応していますが、一部のフィールドは DXVA 2 では使用されなくなっています。

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

各言語での定義

#include <windows.h>

// DXVA2_DecodeBufferDesc  (x64 48 / x86 44 バイト)
typedef struct DXVA2_DecodeBufferDesc {
    DWORD CompressedBufferType;
    DWORD BufferIndex;
    DWORD DataOffset;
    DWORD DataSize;
    DWORD FirstMBaddress;
    DWORD NumMBsInBuffer;
    DWORD Width;
    DWORD Height;
    DWORD Stride;
    DWORD ReservedBits;
    void* pvPVPState;
} DXVA2_DecodeBufferDesc;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DXVA2_DecodeBufferDesc
{
    public uint CompressedBufferType;
    public uint BufferIndex;
    public uint DataOffset;
    public uint DataSize;
    public uint FirstMBaddress;
    public uint NumMBsInBuffer;
    public uint Width;
    public uint Height;
    public uint Stride;
    public uint ReservedBits;
    public IntPtr pvPVPState;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DXVA2_DecodeBufferDesc
    Public CompressedBufferType As UInteger
    Public BufferIndex As UInteger
    Public DataOffset As UInteger
    Public DataSize As UInteger
    Public FirstMBaddress As UInteger
    Public NumMBsInBuffer As UInteger
    Public Width As UInteger
    Public Height As UInteger
    Public Stride As UInteger
    Public ReservedBits As UInteger
    Public pvPVPState As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DXVA2_DecodeBufferDesc(ctypes.Structure):
    _fields_ = [
        ("CompressedBufferType", wintypes.DWORD),
        ("BufferIndex", wintypes.DWORD),
        ("DataOffset", wintypes.DWORD),
        ("DataSize", wintypes.DWORD),
        ("FirstMBaddress", wintypes.DWORD),
        ("NumMBsInBuffer", wintypes.DWORD),
        ("Width", wintypes.DWORD),
        ("Height", wintypes.DWORD),
        ("Stride", wintypes.DWORD),
        ("ReservedBits", wintypes.DWORD),
        ("pvPVPState", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DXVA2_DecodeBufferDesc {
    pub CompressedBufferType: u32,
    pub BufferIndex: u32,
    pub DataOffset: u32,
    pub DataSize: u32,
    pub FirstMBaddress: u32,
    pub NumMBsInBuffer: u32,
    pub Width: u32,
    pub Height: u32,
    pub Stride: u32,
    pub ReservedBits: u32,
    pub pvPVPState: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DXVA2_DecodeBufferDesc struct {
	CompressedBufferType uint32
	BufferIndex uint32
	DataOffset uint32
	DataSize uint32
	FirstMBaddress uint32
	NumMBsInBuffer uint32
	Width uint32
	Height uint32
	Stride uint32
	ReservedBits uint32
	pvPVPState uintptr
}
type
  DXVA2_DecodeBufferDesc = record
    CompressedBufferType: DWORD;
    BufferIndex: DWORD;
    DataOffset: DWORD;
    DataSize: DWORD;
    FirstMBaddress: DWORD;
    NumMBsInBuffer: DWORD;
    Width: DWORD;
    Height: DWORD;
    Stride: DWORD;
    ReservedBits: DWORD;
    pvPVPState: Pointer;
  end;
const DXVA2_DecodeBufferDesc = extern struct {
    CompressedBufferType: u32,
    BufferIndex: u32,
    DataOffset: u32,
    DataSize: u32,
    FirstMBaddress: u32,
    NumMBsInBuffer: u32,
    Width: u32,
    Height: u32,
    Stride: u32,
    ReservedBits: u32,
    pvPVPState: ?*anyopaque,
};
type
  DXVA2_DecodeBufferDesc {.bycopy.} = object
    CompressedBufferType: uint32
    BufferIndex: uint32
    DataOffset: uint32
    DataSize: uint32
    FirstMBaddress: uint32
    NumMBsInBuffer: uint32
    Width: uint32
    Height: uint32
    Stride: uint32
    ReservedBits: uint32
    pvPVPState: pointer
struct DXVA2_DecodeBufferDesc
{
    uint CompressedBufferType;
    uint BufferIndex;
    uint DataOffset;
    uint DataSize;
    uint FirstMBaddress;
    uint NumMBsInBuffer;
    uint Width;
    uint Height;
    uint Stride;
    uint ReservedBits;
    void* pvPVPState;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DXVA2_DecodeBufferDesc サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; CompressedBufferType : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; BufferIndex : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DataOffset : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DataSize : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; FirstMBaddress : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; NumMBsInBuffer : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Width : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Height : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; Stride : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ReservedBits : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pvPVPState : void* (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DXVA2_DecodeBufferDesc サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; CompressedBufferType : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; BufferIndex : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DataOffset : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DataSize : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; FirstMBaddress : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; NumMBsInBuffer : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Width : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Height : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; Stride : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ReservedBits : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; pvPVPState : void* (+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 DXVA2_DecodeBufferDesc
    #field int CompressedBufferType
    #field int BufferIndex
    #field int DataOffset
    #field int DataSize
    #field int FirstMBaddress
    #field int NumMBsInBuffer
    #field int Width
    #field int Height
    #field int Stride
    #field int ReservedBits
    #field intptr pvPVPState
#endstruct

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