ホーム › Media.WindowsMediaFormat › WMT_VIDEOIMAGE_SAMPLE

WMT_VIDEOIMAGE_SAMPLE

構造体

📘 Microsoft Learn (日本語) · English

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

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

フィールド

型

サイズ

x64

x86

説明

dwMagic

DWORD

予約済みの値です。常に WMT_VIDEOIMAGE_MAGIC_NUMBER を設定します。

cbStruct

DWORD

構造体のサイズです。常に sizeof(WMT_VIDEOIMAGE_SAMPLE) を設定します。

dwControlFlags

DWORD

次の値の 1 つ以上を指定します。

Value	Description
WMT_VIDEOIMAGE_SAMPLE_INPUT_FRAME	サンプルに入力画像が含まれることを示します。画像データはサンプル内で構造体の直後に続けて配置する必要があり、ストリームの入力プロパティに設定された値に準拠していなければなりません。
WMT_VIDEOIMAGE_SAMPLE_OUTPUT_FRAME	サンプルがストリーム内で固有のフレームになることを示します。このフラグが設定されていない場合、構造体の残りのメンバーは無視され、ストリーム内のフレームは直前の出力ストリームと同一になります。
WMT_VIDEOIMAGE_SAMPLE_USES_CURRENT_INPUT_FRAME	サンプルが現在の画像に全面的または部分的に基づくことを示します。このフラグが設定されている場合、1 つ目の値メンバーのセットが使用されます。サンプルが入力専用の場合、このフラグは設定できません。
WMT_VIDEOIMAGE_SAMPLE_USES_PREVIOUS_INPUT_FRAME	サンプルが直前の画像に全面的または部分的に基づくことを示します。このフラグが設定されている場合、2 つ目の値メンバーのセットが使用されます。サンプルが入力専用の場合、このフラグは設定できません。

dwInputFlagsCur

DWORD

+12

現在の画像に対して実行する操作を示す 1 つ以上のフラグです。次のフラグを使用できます。

Value	Description
WMT_VIDEOIMAGE_SAMPLE_ADV_BLENDING	サンプルが高度なブレンドを使用することを示します。この機能は現在のバージョンではサポートされていません。
WMT_VIDEOIMAGE_SAMPLE_BLENDING	サンプルにブレンドが含まれることを示します。このフラグが設定されている場合、lCurBlendCoef1 と lPrevBlendCoef1 の値の合計 (分母を乗算する前の値) は 1 でなければなりません。
WMT_VIDEOIMAGE_SAMPLE_MOTION	サンプルがパンまたはズーム (あるいはその両方) を使用することを示します。
WMT_VIDEOIMAGE_SAMPLE_ROTATION	サンプルが回転を使用することを示します。この機能は現在のバージョンではサポートされていません。

lCurMotionXtoX

INT

+16

現在の画像の水平方向の拡大縮小率を格納する LONG 値です。拡大縮小率が 1 の場合、このサンプルでは水平方向の拡大縮小は行われません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lCurMotionYtoX

INT

+20

使用されません。

lCurMotionXoffset

INT

+24

直前の出力サンプルを基準とした、現在の画像の水平方向のオフセット (ピクセル単位) を格納する LONG 値です。オフセットが 0 の場合、このサンプルではパンは行われません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lCurMotionXtoY

INT

+28

使用されません。

lCurMotionYtoY

INT

+32

現在の画像の垂直方向の拡大縮小率を格納する LONG 値です。拡大縮小率が 1 の場合、このサンプルでは垂直方向の拡大縮小は行われません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lCurMotionYoffset

INT

+36

直前の出力サンプルを基準とした、現在の画像の垂直方向のオフセット (ピクセル単位) を格納する LONG 値です。オフセットが 0 の場合、このサンプルではパンは行われません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lCurBlendCoef1

INT

+40

出力のために直前の画像と合成するときの、現在の画像のブレンド係数を格納する LONG 値です。この係数と直前の画像の係数の合計は 1 でなければなりません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lCurBlendCoef2

INT

+44

使用されません。

dwInputFlagsPrev

DWORD

+48

直前の画像に対して実行する操作を示す 1 つ以上のフラグです。次のフラグを使用できます。

Value	Description
WMT_VIDEOIMAGE_SAMPLE_ADV_BLENDING	サンプルが高度なブレンドを使用することを示します。この機能は現在のバージョンではサポートされていません。
WMT_VIDEOIMAGE_SAMPLE_BLENDING	サンプルにブレンドが含まれることを示します。このフラグが設定されている場合、lCurBlendCoef1 と lPrevBlendCoef1 の値の合計 (分母を乗算する前の値) は 1 でなければなりません。
WMT_VIDEOIMAGE_SAMPLE_MOTION	サンプルがパンまたはズーム (あるいはその両方) を使用することを示します。
WMT_VIDEOIMAGE_SAMPLE_ROTATION	サンプルが回転を使用することを示します。この機能は現在のバージョンではサポートされていません。

lPrevMotionXtoX

INT

+52

直前の画像の水平方向の拡大縮小率を格納する LONG 値です。拡大縮小率が 1 の場合、このサンプルでは水平方向の拡大縮小は行われません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lPrevMotionYtoX

INT

+56

使用されません。

lPrevMotionXoffset

INT

+60

直前の出力サンプルを基準とした、直前の画像の水平方向のオフセット (ピクセル単位) を格納する LONG 値です。オフセットが 0 の場合、このサンプルではパンは行われません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lPrevMotionXtoY

INT

+64

使用されません。

lPrevMotionYtoY

INT

+68

直前の画像の垂直方向の拡大縮小率を格納する LONG 値です。拡大縮小率が 1 の場合、このサンプルでは垂直方向の拡大縮小は行われません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lPrevMotionYoffset

INT

+72

直前の出力サンプルを基準とした、直前の画像の垂直方向のオフセット (ピクセル単位) を格納する LONG 値です。オフセットが 0 の場合、このサンプルではパンは行われません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lPrevBlendCoef1

INT

+76

出力のために現在の画像と合成するときの、直前の画像のブレンド係数を格納する LONG 値です。この係数と現在の画像の係数の合計は 1 でなければなりません。この値は、構造体に設定する前に WMT_VIDEOIMAGE_INTEGER_DENOMINATOR を乗算しなければなりません。

lPrevBlendCoef2

INT

+80

使用されません。

公式ドキュメント

[このページに関連する機能である Windows Media Format 11 SDK はレガシー機能です。この機能は Source Reader と Sink Writer に置き換えられました。Source Reader と Sink Writer は Windows 10 および Windows 11 向けに最適化されています。可能な場合、新しいコードでは Windows Media Format 11 SDK ではなく Source Reader と Sink Writer を使用することを Microsoft は強く推奨します。レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き換えることを Microsoft は推奨します。]

[この構造体は、Windows Media Video 9 Image v2 コーデック以降では使用できません。代わりに WMT_VIDEOIMAGE_SAMPLE2 を使用してください。]

WMT_VIDEOIMAGE_SAMPLE 構造体は、Windows Media Video 9 Image コーデックを使用する Video Image ストリームのサンプルを記述します。

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

各言語での定義

#include <windows.h>

// WMT_VIDEOIMAGE_SAMPLE  (x64 84 / x86 84 バイト)
typedef struct WMT_VIDEOIMAGE_SAMPLE {
    DWORD dwMagic;
    DWORD cbStruct;
    DWORD dwControlFlags;
    DWORD dwInputFlagsCur;
    INT lCurMotionXtoX;
    INT lCurMotionYtoX;
    INT lCurMotionXoffset;
    INT lCurMotionXtoY;
    INT lCurMotionYtoY;
    INT lCurMotionYoffset;
    INT lCurBlendCoef1;
    INT lCurBlendCoef2;
    DWORD dwInputFlagsPrev;
    INT lPrevMotionXtoX;
    INT lPrevMotionYtoX;
    INT lPrevMotionXoffset;
    INT lPrevMotionXtoY;
    INT lPrevMotionYtoY;
    INT lPrevMotionYoffset;
    INT lPrevBlendCoef1;
    INT lPrevBlendCoef2;
} WMT_VIDEOIMAGE_SAMPLE;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WMT_VIDEOIMAGE_SAMPLE
{
    public uint dwMagic;
    public uint cbStruct;
    public uint dwControlFlags;
    public uint dwInputFlagsCur;
    public int lCurMotionXtoX;
    public int lCurMotionYtoX;
    public int lCurMotionXoffset;
    public int lCurMotionXtoY;
    public int lCurMotionYtoY;
    public int lCurMotionYoffset;
    public int lCurBlendCoef1;
    public int lCurBlendCoef2;
    public uint dwInputFlagsPrev;
    public int lPrevMotionXtoX;
    public int lPrevMotionYtoX;
    public int lPrevMotionXoffset;
    public int lPrevMotionXtoY;
    public int lPrevMotionYtoY;
    public int lPrevMotionYoffset;
    public int lPrevBlendCoef1;
    public int lPrevBlendCoef2;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WMT_VIDEOIMAGE_SAMPLE
    Public dwMagic As UInteger
    Public cbStruct As UInteger
    Public dwControlFlags As UInteger
    Public dwInputFlagsCur As UInteger
    Public lCurMotionXtoX As Integer
    Public lCurMotionYtoX As Integer
    Public lCurMotionXoffset As Integer
    Public lCurMotionXtoY As Integer
    Public lCurMotionYtoY As Integer
    Public lCurMotionYoffset As Integer
    Public lCurBlendCoef1 As Integer
    Public lCurBlendCoef2 As Integer
    Public dwInputFlagsPrev As UInteger
    Public lPrevMotionXtoX As Integer
    Public lPrevMotionYtoX As Integer
    Public lPrevMotionXoffset As Integer
    Public lPrevMotionXtoY As Integer
    Public lPrevMotionYtoY As Integer
    Public lPrevMotionYoffset As Integer
    Public lPrevBlendCoef1 As Integer
    Public lPrevBlendCoef2 As Integer
End Structure

import ctypes
from ctypes import wintypes

class WMT_VIDEOIMAGE_SAMPLE(ctypes.Structure):
    _fields_ = [
        ("dwMagic", wintypes.DWORD),
        ("cbStruct", wintypes.DWORD),
        ("dwControlFlags", wintypes.DWORD),
        ("dwInputFlagsCur", wintypes.DWORD),
        ("lCurMotionXtoX", ctypes.c_int),
        ("lCurMotionYtoX", ctypes.c_int),
        ("lCurMotionXoffset", ctypes.c_int),
        ("lCurMotionXtoY", ctypes.c_int),
        ("lCurMotionYtoY", ctypes.c_int),
        ("lCurMotionYoffset", ctypes.c_int),
        ("lCurBlendCoef1", ctypes.c_int),
        ("lCurBlendCoef2", ctypes.c_int),
        ("dwInputFlagsPrev", wintypes.DWORD),
        ("lPrevMotionXtoX", ctypes.c_int),
        ("lPrevMotionYtoX", ctypes.c_int),
        ("lPrevMotionXoffset", ctypes.c_int),
        ("lPrevMotionXtoY", ctypes.c_int),
        ("lPrevMotionYtoY", ctypes.c_int),
        ("lPrevMotionYoffset", ctypes.c_int),
        ("lPrevBlendCoef1", ctypes.c_int),
        ("lPrevBlendCoef2", ctypes.c_int),
    ]

#[repr(C)]
pub struct WMT_VIDEOIMAGE_SAMPLE {
    pub dwMagic: u32,
    pub cbStruct: u32,
    pub dwControlFlags: u32,
    pub dwInputFlagsCur: u32,
    pub lCurMotionXtoX: i32,
    pub lCurMotionYtoX: i32,
    pub lCurMotionXoffset: i32,
    pub lCurMotionXtoY: i32,
    pub lCurMotionYtoY: i32,
    pub lCurMotionYoffset: i32,
    pub lCurBlendCoef1: i32,
    pub lCurBlendCoef2: i32,
    pub dwInputFlagsPrev: u32,
    pub lPrevMotionXtoX: i32,
    pub lPrevMotionYtoX: i32,
    pub lPrevMotionXoffset: i32,
    pub lPrevMotionXtoY: i32,
    pub lPrevMotionYtoY: i32,
    pub lPrevMotionYoffset: i32,
    pub lPrevBlendCoef1: i32,
    pub lPrevBlendCoef2: i32,
}

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

type WMT_VIDEOIMAGE_SAMPLE struct {
	dwMagic uint32
	cbStruct uint32
	dwControlFlags uint32
	dwInputFlagsCur uint32
	lCurMotionXtoX int32
	lCurMotionYtoX int32
	lCurMotionXoffset int32
	lCurMotionXtoY int32
	lCurMotionYtoY int32
	lCurMotionYoffset int32
	lCurBlendCoef1 int32
	lCurBlendCoef2 int32
	dwInputFlagsPrev uint32
	lPrevMotionXtoX int32
	lPrevMotionYtoX int32
	lPrevMotionXoffset int32
	lPrevMotionXtoY int32
	lPrevMotionYtoY int32
	lPrevMotionYoffset int32
	lPrevBlendCoef1 int32
	lPrevBlendCoef2 int32
}

type
  WMT_VIDEOIMAGE_SAMPLE = record
    dwMagic: DWORD;
    cbStruct: DWORD;
    dwControlFlags: DWORD;
    dwInputFlagsCur: DWORD;
    lCurMotionXtoX: Integer;
    lCurMotionYtoX: Integer;
    lCurMotionXoffset: Integer;
    lCurMotionXtoY: Integer;
    lCurMotionYtoY: Integer;
    lCurMotionYoffset: Integer;
    lCurBlendCoef1: Integer;
    lCurBlendCoef2: Integer;
    dwInputFlagsPrev: DWORD;
    lPrevMotionXtoX: Integer;
    lPrevMotionYtoX: Integer;
    lPrevMotionXoffset: Integer;
    lPrevMotionXtoY: Integer;
    lPrevMotionYtoY: Integer;
    lPrevMotionYoffset: Integer;
    lPrevBlendCoef1: Integer;
    lPrevBlendCoef2: Integer;
  end;

const WMT_VIDEOIMAGE_SAMPLE = extern struct {
    dwMagic: u32,
    cbStruct: u32,
    dwControlFlags: u32,
    dwInputFlagsCur: u32,
    lCurMotionXtoX: i32,
    lCurMotionYtoX: i32,
    lCurMotionXoffset: i32,
    lCurMotionXtoY: i32,
    lCurMotionYtoY: i32,
    lCurMotionYoffset: i32,
    lCurBlendCoef1: i32,
    lCurBlendCoef2: i32,
    dwInputFlagsPrev: u32,
    lPrevMotionXtoX: i32,
    lPrevMotionYtoX: i32,
    lPrevMotionXoffset: i32,
    lPrevMotionXtoY: i32,
    lPrevMotionYtoY: i32,
    lPrevMotionYoffset: i32,
    lPrevBlendCoef1: i32,
    lPrevBlendCoef2: i32,
};

type
  WMT_VIDEOIMAGE_SAMPLE {.bycopy.} = object
    dwMagic: uint32
    cbStruct: uint32
    dwControlFlags: uint32
    dwInputFlagsCur: uint32
    lCurMotionXtoX: int32
    lCurMotionYtoX: int32
    lCurMotionXoffset: int32
    lCurMotionXtoY: int32
    lCurMotionYtoY: int32
    lCurMotionYoffset: int32
    lCurBlendCoef1: int32
    lCurBlendCoef2: int32
    dwInputFlagsPrev: uint32
    lPrevMotionXtoX: int32
    lPrevMotionYtoX: int32
    lPrevMotionXoffset: int32
    lPrevMotionXtoY: int32
    lPrevMotionYtoY: int32
    lPrevMotionYoffset: int32
    lPrevBlendCoef1: int32
    lPrevBlendCoef2: int32

struct WMT_VIDEOIMAGE_SAMPLE
{
    uint dwMagic;
    uint cbStruct;
    uint dwControlFlags;
    uint dwInputFlagsCur;
    int lCurMotionXtoX;
    int lCurMotionYtoX;
    int lCurMotionXoffset;
    int lCurMotionXtoY;
    int lCurMotionYtoY;
    int lCurMotionYoffset;
    int lCurBlendCoef1;
    int lCurBlendCoef2;
    uint dwInputFlagsPrev;
    int lPrevMotionXtoX;
    int lPrevMotionYtoX;
    int lPrevMotionXoffset;
    int lPrevMotionXtoY;
    int lPrevMotionYtoY;
    int lPrevMotionYoffset;
    int lPrevBlendCoef1;
    int lPrevBlendCoef2;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WMT_VIDEOIMAGE_SAMPLE サイズ: 84 バイト(x64)
dim st, 21    ; 4byte整数×21(構造体サイズ 84 / 4 切り上げ)
; dwMagic : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; cbStruct : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwControlFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwInputFlagsCur : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lCurMotionXtoX : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lCurMotionYtoX : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lCurMotionXoffset : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lCurMotionXtoY : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; lCurMotionYtoY : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; lCurMotionYoffset : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lCurBlendCoef1 : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; lCurBlendCoef2 : INT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwInputFlagsPrev : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; lPrevMotionXtoX : INT (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; lPrevMotionYtoX : INT (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; lPrevMotionXoffset : INT (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; lPrevMotionXtoY : INT (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; lPrevMotionYtoY : INT (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; lPrevMotionYoffset : INT (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; lPrevBlendCoef1 : INT (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; lPrevBlendCoef2 : INT (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WMT_VIDEOIMAGE_SAMPLE
    #field int dwMagic
    #field int cbStruct
    #field int dwControlFlags
    #field int dwInputFlagsCur
    #field int lCurMotionXtoX
    #field int lCurMotionYtoX
    #field int lCurMotionXoffset
    #field int lCurMotionXtoY
    #field int lCurMotionYtoY
    #field int lCurMotionYoffset
    #field int lCurBlendCoef1
    #field int lCurBlendCoef2
    #field int dwInputFlagsPrev
    #field int lPrevMotionXtoX
    #field int lPrevMotionYtoX
    #field int lPrevMotionXoffset
    #field int lPrevMotionXtoY
    #field int lPrevMotionYtoY
    #field int lPrevMotionYoffset
    #field int lPrevBlendCoef1
    #field int lPrevBlendCoef2
#endstruct

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

WMT_VIDEOIMAGE_SAMPLE

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義