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

MPEG2VIDEOINFO

構造体
サイズx64: 136 バイト / x86: 136 バイト

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

フィールド

フィールドサイズx64x86説明
hdrVIDEOINFOHEADER2112+0+0VIDEOINFOHEADER2 構造体です。
dwStartTimeCodeDWORD4+112+112データの先頭における 25 ビットの GOP (group-of-pictures) タイム コードです。このフィールドは DVD では使用されません。
cbSequenceHeaderDWORD4+116+116シーケンス ヘッダーの長さ (バイト単位)。DVD の場合、このフィールドは 0 に設定します。シーケンス ヘッダーは dwSequenceHeader フィールドで指定します。
dwProfileDWORD4+120+120MPEG-2 プロファイルを AM_MPEG2Profile 列挙型として指定します。
dwLevelDWORD4+124+124MPEG-2 レベルを AM_MPEG2Level 列挙型として指定します。
dwFlagsMPEG2VIDEOINFO_FLAGS4+128+128

優先設定を示すフラグです。次の値のいずれか、またはそれらの組み合わせを設定します。

意味
AMMPEG2_DoPanScan
0x00000001
このフラグが設定されている場合、MPEG-2 ビデオ デコーダーは picture_display_extension 内のパン スキャン ベクターに基づいて出力画像を切り取り、ピクチャーのアスペクト比を 4x3 に変更します。VMR はこのフラグが設定された 16x9 のサンプルを受け取ってはなりません。単純な実装では、ソース矩形を変更し、picture_display_extension 内の表示オフセットに等しい左端を持つ幅 540 のソース領域を示すようにすることが考えられます。
AMMPEG2_DVDLine21Field1
0x00000002
設定されている場合、MPEG-2 デコーダーは、フィールド 1 の GOP (Group Of Pictures) レイヤーにある DVD 形式のクローズド キャプション データ用の出力ピンを生成できなければなりません。
AMMPEG2_DVDLine21Field2
0x00000004
設定されている場合、MPEG-2 デコーダーは、フィールド 2 の GOP レイヤーにある DVD 形式のクローズド キャプション データ用の出力ピンを生成できなければなりません。
AMMPEG2_SourceIsLetterboxed
0x00000008
設定されている場合、ビデオの上下に黒い帯がエンコードされていることを示します。
AMMPEG2_FilmCameraMode
0x00000010
設定されている場合、625/50 (ライン/フィールド) のコンテンツに「フィルム モード」が使用されたことを示します。クリアされている場合は「カメラ モード」が使用されたことを示します。
AMMPEG2_LetterboxAnalogOut
0x00000020
設定されていて、かつこのストリームがアナログ出力に送られる場合、レターボックス表示にする必要があります。VGA に送られるストリームは、レンダラーによってのみレターボックス化されるべきです。
AMMPEG2_DSS_UserData
0x00000040
設定されている場合、MPEG-2 デコーダーは DSS 形式のユーザー データを処理しなければなりません。
AMMPEG2_DVB_UserData
0x00000080
設定されている場合、MPEG-2 デコーダーは DVB 形式のユーザー データを処理しなければなりません。
AMMPEG2_27MhzTimebase
0x00000100
設定されている場合、PTS および DTS のタイムスタンプは 90KHz ではなく 27MHz で進みます。
AMMPEG2_WidescreenAnalogOut
0x00000200
設定されていて、かつこのストリームがアナログ出力に送られる場合、ワイドスクリーン形式にする必要があります (4x3 のコンテンツは 16x9 の出力の中央に配置します)。VGA に送られるストリームは、レンダラーによってのみワイドスクリーン化されるべきです。

未定義のフラグは 0 に設定してください。そうしないと接続が拒否されます。これらのフラグの使用方法の詳細については、MPEG Decoder Preprocessing Transformations を参照してください。

dwSequenceHeaderDWORD4+132+132シーケンス ヘッダー (必要に応じて量子化行列とシーケンス拡張を含む) を格納する配列の先頭です。このフィールドは 32 ビット境界への整列を強制するために DWORD 配列として定義されています。配列のサイズ (バイト単位) は cbSequenceHeader メンバーで指定されます。

公式ドキュメント

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

MPEG2VIDEOINFO 構造体は、MPEG-2 ビデオ ストリームを記述します。

解説(Remarks)

VIDEOINFOHEADER2 構造体 (hdr) に含まれる BITMAPINFOHEADER 構造体の後ろに、パレット エントリやカラー マスクを続けることはできません。この構造体の直後には dwStartTimeCode メンバーが続くためです。

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

各言語での定義

#include <windows.h>

// RECT  (x64 16 / x86 16 バイト)
typedef struct RECT {
    INT left;
    INT top;
    INT right;
    INT bottom;
} RECT;

// BITMAPINFOHEADER  (x64 40 / x86 40 バイト)
typedef struct BITMAPINFOHEADER {
    DWORD biSize;
    INT biWidth;
    INT biHeight;
    WORD biPlanes;
    WORD biBitCount;
    DWORD biCompression;
    DWORD biSizeImage;
    INT biXPelsPerMeter;
    INT biYPelsPerMeter;
    DWORD biClrUsed;
    DWORD biClrImportant;
} BITMAPINFOHEADER;

// VIDEOINFOHEADER2  (x64 112 / x86 112 バイト)
typedef struct VIDEOINFOHEADER2 {
    RECT rcSource;
    RECT rcTarget;
    DWORD dwBitRate;
    DWORD dwBitErrorRate;
    LONGLONG AvgTimePerFrame;
    DWORD dwInterlaceFlags;
    DWORD dwCopyProtectFlags;
    DWORD dwPictAspectRatioX;
    DWORD dwPictAspectRatioY;
    _Anonymous_e__Union Anonymous;
    DWORD dwReserved2;
    BITMAPINFOHEADER bmiHeader;
} VIDEOINFOHEADER2;

// MPEG2VIDEOINFO  (x64 136 / x86 136 バイト)
typedef struct MPEG2VIDEOINFO {
    VIDEOINFOHEADER2 hdr;
    DWORD dwStartTimeCode;
    DWORD cbSequenceHeader;
    DWORD dwProfile;
    DWORD dwLevel;
    MPEG2VIDEOINFO_FLAGS dwFlags;
    DWORD dwSequenceHeader[1];
} MPEG2VIDEOINFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RECT
{
    public int left;
    public int top;
    public int right;
    public int bottom;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BITMAPINFOHEADER
{
    public uint biSize;
    public int biWidth;
    public int biHeight;
    public ushort biPlanes;
    public ushort biBitCount;
    public uint biCompression;
    public uint biSizeImage;
    public int biXPelsPerMeter;
    public int biYPelsPerMeter;
    public uint biClrUsed;
    public uint biClrImportant;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VIDEOINFOHEADER2
{
    public RECT rcSource;
    public RECT rcTarget;
    public uint dwBitRate;
    public uint dwBitErrorRate;
    public long AvgTimePerFrame;
    public uint dwInterlaceFlags;
    public uint dwCopyProtectFlags;
    public uint dwPictAspectRatioX;
    public uint dwPictAspectRatioY;
    public _Anonymous_e__Union Anonymous;
    public uint dwReserved2;
    public BITMAPINFOHEADER bmiHeader;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MPEG2VIDEOINFO
{
    public VIDEOINFOHEADER2 hdr;
    public uint dwStartTimeCode;
    public uint cbSequenceHeader;
    public uint dwProfile;
    public uint dwLevel;
    public uint dwFlags;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public uint[] dwSequenceHeader;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RECT
    Public left As Integer
    Public top As Integer
    Public right As Integer
    Public bottom As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BITMAPINFOHEADER
    Public biSize As UInteger
    Public biWidth As Integer
    Public biHeight As Integer
    Public biPlanes As UShort
    Public biBitCount As UShort
    Public biCompression As UInteger
    Public biSizeImage As UInteger
    Public biXPelsPerMeter As Integer
    Public biYPelsPerMeter As Integer
    Public biClrUsed As UInteger
    Public biClrImportant As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VIDEOINFOHEADER2
    Public rcSource As RECT
    Public rcTarget As RECT
    Public dwBitRate As UInteger
    Public dwBitErrorRate As UInteger
    Public AvgTimePerFrame As Long
    Public dwInterlaceFlags As UInteger
    Public dwCopyProtectFlags As UInteger
    Public dwPictAspectRatioX As UInteger
    Public dwPictAspectRatioY As UInteger
    Public Anonymous As _Anonymous_e__Union
    Public dwReserved2 As UInteger
    Public bmiHeader As BITMAPINFOHEADER
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MPEG2VIDEOINFO
    Public hdr As VIDEOINFOHEADER2
    Public dwStartTimeCode As UInteger
    Public cbSequenceHeader As UInteger
    Public dwProfile As UInteger
    Public dwLevel As UInteger
    Public dwFlags As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public dwSequenceHeader() As UInteger
End Structure
import ctypes
from ctypes import wintypes

class RECT(ctypes.Structure):
    _fields_ = [
        ("left", ctypes.c_int),
        ("top", ctypes.c_int),
        ("right", ctypes.c_int),
        ("bottom", ctypes.c_int),
    ]

class BITMAPINFOHEADER(ctypes.Structure):
    _fields_ = [
        ("biSize", wintypes.DWORD),
        ("biWidth", ctypes.c_int),
        ("biHeight", ctypes.c_int),
        ("biPlanes", ctypes.c_ushort),
        ("biBitCount", ctypes.c_ushort),
        ("biCompression", wintypes.DWORD),
        ("biSizeImage", wintypes.DWORD),
        ("biXPelsPerMeter", ctypes.c_int),
        ("biYPelsPerMeter", ctypes.c_int),
        ("biClrUsed", wintypes.DWORD),
        ("biClrImportant", wintypes.DWORD),
    ]

class VIDEOINFOHEADER2(ctypes.Structure):
    _fields_ = [
        ("rcSource", RECT),
        ("rcTarget", RECT),
        ("dwBitRate", wintypes.DWORD),
        ("dwBitErrorRate", wintypes.DWORD),
        ("AvgTimePerFrame", ctypes.c_longlong),
        ("dwInterlaceFlags", wintypes.DWORD),
        ("dwCopyProtectFlags", wintypes.DWORD),
        ("dwPictAspectRatioX", wintypes.DWORD),
        ("dwPictAspectRatioY", wintypes.DWORD),
        ("Anonymous", _Anonymous_e__Union),
        ("dwReserved2", wintypes.DWORD),
        ("bmiHeader", BITMAPINFOHEADER),
    ]

class MPEG2VIDEOINFO(ctypes.Structure):
    _fields_ = [
        ("hdr", VIDEOINFOHEADER2),
        ("dwStartTimeCode", wintypes.DWORD),
        ("cbSequenceHeader", wintypes.DWORD),
        ("dwProfile", wintypes.DWORD),
        ("dwLevel", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("dwSequenceHeader", wintypes.DWORD * 1),
    ]
#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C)]
pub struct BITMAPINFOHEADER {
    pub biSize: u32,
    pub biWidth: i32,
    pub biHeight: i32,
    pub biPlanes: u16,
    pub biBitCount: u16,
    pub biCompression: u32,
    pub biSizeImage: u32,
    pub biXPelsPerMeter: i32,
    pub biYPelsPerMeter: i32,
    pub biClrUsed: u32,
    pub biClrImportant: u32,
}

#[repr(C)]
pub struct VIDEOINFOHEADER2 {
    pub rcSource: RECT,
    pub rcTarget: RECT,
    pub dwBitRate: u32,
    pub dwBitErrorRate: u32,
    pub AvgTimePerFrame: i64,
    pub dwInterlaceFlags: u32,
    pub dwCopyProtectFlags: u32,
    pub dwPictAspectRatioX: u32,
    pub dwPictAspectRatioY: u32,
    pub Anonymous: _Anonymous_e__Union,
    pub dwReserved2: u32,
    pub bmiHeader: BITMAPINFOHEADER,
}

#[repr(C)]
pub struct MPEG2VIDEOINFO {
    pub hdr: VIDEOINFOHEADER2,
    pub dwStartTimeCode: u32,
    pub cbSequenceHeader: u32,
    pub dwProfile: u32,
    pub dwLevel: u32,
    pub dwFlags: u32,
    pub dwSequenceHeader: [u32; 1],
}
import "golang.org/x/sys/windows"

type RECT struct {
	left int32
	top int32
	right int32
	bottom int32
}

type BITMAPINFOHEADER struct {
	biSize uint32
	biWidth int32
	biHeight int32
	biPlanes uint16
	biBitCount uint16
	biCompression uint32
	biSizeImage uint32
	biXPelsPerMeter int32
	biYPelsPerMeter int32
	biClrUsed uint32
	biClrImportant uint32
}

type VIDEOINFOHEADER2 struct {
	rcSource RECT
	rcTarget RECT
	dwBitRate uint32
	dwBitErrorRate uint32
	AvgTimePerFrame int64
	dwInterlaceFlags uint32
	dwCopyProtectFlags uint32
	dwPictAspectRatioX uint32
	dwPictAspectRatioY uint32
	Anonymous _Anonymous_e__Union
	dwReserved2 uint32
	bmiHeader BITMAPINFOHEADER
}

type MPEG2VIDEOINFO struct {
	hdr VIDEOINFOHEADER2
	dwStartTimeCode uint32
	cbSequenceHeader uint32
	dwProfile uint32
	dwLevel uint32
	dwFlags uint32
	dwSequenceHeader [1]uint32
}
type
  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  BITMAPINFOHEADER = record
    biSize: DWORD;
    biWidth: Integer;
    biHeight: Integer;
    biPlanes: Word;
    biBitCount: Word;
    biCompression: DWORD;
    biSizeImage: DWORD;
    biXPelsPerMeter: Integer;
    biYPelsPerMeter: Integer;
    biClrUsed: DWORD;
    biClrImportant: DWORD;
  end;

  VIDEOINFOHEADER2 = record
    rcSource: RECT;
    rcTarget: RECT;
    dwBitRate: DWORD;
    dwBitErrorRate: DWORD;
    AvgTimePerFrame: Int64;
    dwInterlaceFlags: DWORD;
    dwCopyProtectFlags: DWORD;
    dwPictAspectRatioX: DWORD;
    dwPictAspectRatioY: DWORD;
    Anonymous: _Anonymous_e__Union;
    dwReserved2: DWORD;
    bmiHeader: BITMAPINFOHEADER;
  end;

  MPEG2VIDEOINFO = record
    hdr: VIDEOINFOHEADER2;
    dwStartTimeCode: DWORD;
    cbSequenceHeader: DWORD;
    dwProfile: DWORD;
    dwLevel: DWORD;
    dwFlags: DWORD;
    dwSequenceHeader: array[0..0] of DWORD;
  end;
const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const BITMAPINFOHEADER = extern struct {
    biSize: u32,
    biWidth: i32,
    biHeight: i32,
    biPlanes: u16,
    biBitCount: u16,
    biCompression: u32,
    biSizeImage: u32,
    biXPelsPerMeter: i32,
    biYPelsPerMeter: i32,
    biClrUsed: u32,
    biClrImportant: u32,
};

const VIDEOINFOHEADER2 = extern struct {
    rcSource: RECT,
    rcTarget: RECT,
    dwBitRate: u32,
    dwBitErrorRate: u32,
    AvgTimePerFrame: i64,
    dwInterlaceFlags: u32,
    dwCopyProtectFlags: u32,
    dwPictAspectRatioX: u32,
    dwPictAspectRatioY: u32,
    Anonymous: _Anonymous_e__Union,
    dwReserved2: u32,
    bmiHeader: BITMAPINFOHEADER,
};

const MPEG2VIDEOINFO = extern struct {
    hdr: VIDEOINFOHEADER2,
    dwStartTimeCode: u32,
    cbSequenceHeader: u32,
    dwProfile: u32,
    dwLevel: u32,
    dwFlags: u32,
    dwSequenceHeader: [1]u32,
};
type
  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  BITMAPINFOHEADER {.bycopy.} = object
    biSize: uint32
    biWidth: int32
    biHeight: int32
    biPlanes: uint16
    biBitCount: uint16
    biCompression: uint32
    biSizeImage: uint32
    biXPelsPerMeter: int32
    biYPelsPerMeter: int32
    biClrUsed: uint32
    biClrImportant: uint32

  VIDEOINFOHEADER2 {.bycopy.} = object
    rcSource: RECT
    rcTarget: RECT
    dwBitRate: uint32
    dwBitErrorRate: uint32
    AvgTimePerFrame: int64
    dwInterlaceFlags: uint32
    dwCopyProtectFlags: uint32
    dwPictAspectRatioX: uint32
    dwPictAspectRatioY: uint32
    Anonymous: _Anonymous_e__Union
    dwReserved2: uint32
    bmiHeader: BITMAPINFOHEADER

  MPEG2VIDEOINFO {.bycopy.} = object
    hdr: VIDEOINFOHEADER2
    dwStartTimeCode: uint32
    cbSequenceHeader: uint32
    dwProfile: uint32
    dwLevel: uint32
    dwFlags: uint32
    dwSequenceHeader: array[1, uint32]
struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

struct BITMAPINFOHEADER
{
    uint biSize;
    int biWidth;
    int biHeight;
    ushort biPlanes;
    ushort biBitCount;
    uint biCompression;
    uint biSizeImage;
    int biXPelsPerMeter;
    int biYPelsPerMeter;
    uint biClrUsed;
    uint biClrImportant;
}

struct VIDEOINFOHEADER2
{
    RECT rcSource;
    RECT rcTarget;
    uint dwBitRate;
    uint dwBitErrorRate;
    long AvgTimePerFrame;
    uint dwInterlaceFlags;
    uint dwCopyProtectFlags;
    uint dwPictAspectRatioX;
    uint dwPictAspectRatioY;
    _Anonymous_e__Union Anonymous;
    uint dwReserved2;
    BITMAPINFOHEADER bmiHeader;
}

struct MPEG2VIDEOINFO
{
    VIDEOINFOHEADER2 hdr;
    uint dwStartTimeCode;
    uint cbSequenceHeader;
    uint dwProfile;
    uint dwLevel;
    uint dwFlags;
    uint[1] dwSequenceHeader;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MPEG2VIDEOINFO サイズ: 136 バイト(x64)
dim st, 34    ; 4byte整数×34(構造体サイズ 136 / 4 切り上げ)
; hdr : VIDEOINFOHEADER2 (+0, 112byte)  varptr(st)+0 を基点に操作(112byte:入れ子/配列)
; dwStartTimeCode : DWORD (+112, 4byte)  st.28 = 値  /  値 = st.28   (lpoke/lpeek も可)
; cbSequenceHeader : DWORD (+116, 4byte)  st.29 = 値  /  値 = st.29   (lpoke/lpeek も可)
; dwProfile : DWORD (+120, 4byte)  st.30 = 値  /  値 = st.30   (lpoke/lpeek も可)
; dwLevel : DWORD (+124, 4byte)  st.31 = 値  /  値 = st.31   (lpoke/lpeek も可)
; dwFlags : MPEG2VIDEOINFO_FLAGS (+128, 4byte)  st.32 = 値  /  値 = st.32   (lpoke/lpeek も可)
; dwSequenceHeader : DWORD (+132, 4byte)  varptr(st)+132 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global BITMAPINFOHEADER
    #field int biSize
    #field int biWidth
    #field int biHeight
    #field short biPlanes
    #field short biBitCount
    #field int biCompression
    #field int biSizeImage
    #field int biXPelsPerMeter
    #field int biYPelsPerMeter
    #field int biClrUsed
    #field int biClrImportant
#endstruct

#defstruct global VIDEOINFOHEADER2
    #field RECT rcSource
    #field RECT rcTarget
    #field int dwBitRate
    #field int dwBitErrorRate
    #field int64 AvgTimePerFrame
    #field int dwInterlaceFlags
    #field int dwCopyProtectFlags
    #field int dwPictAspectRatioX
    #field int dwPictAspectRatioY
    #field byte Anonymous 4
    #field int dwReserved2
    #field BITMAPINFOHEADER bmiHeader
#endstruct

#defstruct global MPEG2VIDEOINFO
    #field VIDEOINFOHEADER2 hdr
    #field int dwStartTimeCode
    #field int cbSequenceHeader
    #field int dwProfile
    #field int dwLevel
    #field int dwFlags
    #field int dwSequenceHeader 1
#endstruct

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