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

AMVABeginFrameInfo

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

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

フィールド

フィールド型サイズx64x86説明
dwDestSurfaceIndexDWORD4+0+0非圧縮の転送先サーフェスを示す 0 から始まるインデックスです。非圧縮サーフェスの数は IAMVideoAcceleratorNotify::SetUncompSurfacesInfo メソッドで指定します。
pInputDatavoid*8/4+8+4

ビデオアクセラレーター用のデータを格納するバッファーへのポインターです。

このバッファーには、dwDestSurfaceIndex の値と等しい WORD 値を格納する必要があります。

dwSizeInputDataDWORD4+16+8pInputData が指すバッファーのサイズ (バイト単位) です。値は 2 でなければなりません。
pOutputDatavoid*8/4+24+12

ビデオアクセラレーターが書き込み可能なバッファーへのポインターです。

このメンバーは NULL でなければなりません。

dwSizeOutputDataDWORD4+32+16pOutputData が指すバッファーのサイズ (バイト単位) です。値は 0 でなければなりません。

公式ドキュメント

[このページに関連する機能である DirectShow はレガシー機能です。この機能は MediaPlayer、IMFMediaEngine、および Media Foundation でのオーディオ/ビデオのキャプチャ に置き換えられました。これらの機能は Windows 10 および Windows 11 向けに最適化されています。新しいコードでは、可能な限り DirectShow ではなく MediaPlayer、IMFMediaEngine、Media Foundation でのオーディオ/ビデオのキャプチャ を使用することを Microsoft は強く推奨します。また、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き換えることを Microsoft は推奨します。]

AMVABeginFrameInfo 構造体は、IAMVideoAccelerator::BeginFrame メソッドに渡す情報を格納します。

解説(Remarks)

pInputData が指すバッファーにポインター値を格納することはできません。フレーム処理が行われるカーネルモードでは、それらのアドレスが有効ではないためです。

ビデオアクセラレーターは、同じフレームインデックスで連続して呼び出された場合でも、同一のサーフェスメモリを使用するとは限りません。 そのため、デコーダーはフレームの初期内容について何も想定してはなりません。

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

各言語での定義

#include <windows.h>

// AMVABeginFrameInfo  (x64 40 / x86 20 バイト)
typedef struct AMVABeginFrameInfo {
    DWORD dwDestSurfaceIndex;
    void* pInputData;
    DWORD dwSizeInputData;
    void* pOutputData;
    DWORD dwSizeOutputData;
} AMVABeginFrameInfo;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct AMVABeginFrameInfo
{
    public uint dwDestSurfaceIndex;
    public IntPtr pInputData;
    public uint dwSizeInputData;
    public IntPtr pOutputData;
    public uint dwSizeOutputData;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure AMVABeginFrameInfo
    Public dwDestSurfaceIndex As UInteger
    Public pInputData As IntPtr
    Public dwSizeInputData As UInteger
    Public pOutputData As IntPtr
    Public dwSizeOutputData As UInteger
End Structure
import ctypes
from ctypes import wintypes

class AMVABeginFrameInfo(ctypes.Structure):
    _fields_ = [
        ("dwDestSurfaceIndex", wintypes.DWORD),
        ("pInputData", ctypes.c_void_p),
        ("dwSizeInputData", wintypes.DWORD),
        ("pOutputData", ctypes.c_void_p),
        ("dwSizeOutputData", wintypes.DWORD),
    ]
#[repr(C)]
pub struct AMVABeginFrameInfo {
    pub dwDestSurfaceIndex: u32,
    pub pInputData: *mut core::ffi::c_void,
    pub dwSizeInputData: u32,
    pub pOutputData: *mut core::ffi::c_void,
    pub dwSizeOutputData: u32,
}
import "golang.org/x/sys/windows"

type AMVABeginFrameInfo struct {
	dwDestSurfaceIndex uint32
	pInputData uintptr
	dwSizeInputData uint32
	pOutputData uintptr
	dwSizeOutputData uint32
}
type
  AMVABeginFrameInfo = record
    dwDestSurfaceIndex: DWORD;
    pInputData: Pointer;
    dwSizeInputData: DWORD;
    pOutputData: Pointer;
    dwSizeOutputData: DWORD;
  end;
const AMVABeginFrameInfo = extern struct {
    dwDestSurfaceIndex: u32,
    pInputData: ?*anyopaque,
    dwSizeInputData: u32,
    pOutputData: ?*anyopaque,
    dwSizeOutputData: u32,
};
type
  AMVABeginFrameInfo {.bycopy.} = object
    dwDestSurfaceIndex: uint32
    pInputData: pointer
    dwSizeInputData: uint32
    pOutputData: pointer
    dwSizeOutputData: uint32
struct AMVABeginFrameInfo
{
    uint dwDestSurfaceIndex;
    void* pInputData;
    uint dwSizeInputData;
    void* pOutputData;
    uint dwSizeOutputData;
}

HSP用 定義

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

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

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