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

VMR9VideoDesc

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

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

フィールド

フィールド型サイズx64x86説明
dwSizeDWORD4+0+0構造体のサイズ (バイト単位)。
dwSampleWidthDWORD4+4+4デインターレースするビデオの幅 (ピクセル単位)。
dwSampleHeightDWORD4+8+8デインターレースするビデオの高さ (ピクセル単位)。
SampleFormatVMR9_SampleFormat4+12+12サンプルのインターレース形式を、VMR9_SampleFormat 列挙型のメンバーとして指定します。
dwFourCCDWORD4+16+16FOURCC コードを指定します。有効な値には NV12、YV12、YUY2、UYVY、IMC1、IMC2、IMC3、IMC4 が含まれます。
InputSampleFreqVMR9Frequency8+20+20入力周波数を指定する VMR9Frequency 構造体です。NTSC TV の場合、周波数は 30,000:1001 と表されます。
OutputFrameFreqVMR9Frequency8+28+28出力周波数を指定する VMRFrequency 構造体です。NTSC TV の場合、周波数は 60,000:1001 と表されます。

公式ドキュメント

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

VMR9VideoDesc 構造体は、デインターレース対象のビデオ ストリームを記述します。

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

各言語での定義

#include <windows.h>

// VMR9Frequency  (x64 8 / x86 8 バイト)
typedef struct VMR9Frequency {
    DWORD dwNumerator;
    DWORD dwDenominator;
} VMR9Frequency;

// VMR9VideoDesc  (x64 36 / x86 36 バイト)
typedef struct VMR9VideoDesc {
    DWORD dwSize;
    DWORD dwSampleWidth;
    DWORD dwSampleHeight;
    VMR9_SampleFormat SampleFormat;
    DWORD dwFourCC;
    VMR9Frequency InputSampleFreq;
    VMR9Frequency OutputFrameFreq;
} VMR9VideoDesc;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VMR9Frequency
{
    public uint dwNumerator;
    public uint dwDenominator;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VMR9VideoDesc
{
    public uint dwSize;
    public uint dwSampleWidth;
    public uint dwSampleHeight;
    public int SampleFormat;
    public uint dwFourCC;
    public VMR9Frequency InputSampleFreq;
    public VMR9Frequency OutputFrameFreq;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VMR9Frequency
    Public dwNumerator As UInteger
    Public dwDenominator As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VMR9VideoDesc
    Public dwSize As UInteger
    Public dwSampleWidth As UInteger
    Public dwSampleHeight As UInteger
    Public SampleFormat As Integer
    Public dwFourCC As UInteger
    Public InputSampleFreq As VMR9Frequency
    Public OutputFrameFreq As VMR9Frequency
End Structure
import ctypes
from ctypes import wintypes

class VMR9Frequency(ctypes.Structure):
    _fields_ = [
        ("dwNumerator", wintypes.DWORD),
        ("dwDenominator", wintypes.DWORD),
    ]

class VMR9VideoDesc(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwSampleWidth", wintypes.DWORD),
        ("dwSampleHeight", wintypes.DWORD),
        ("SampleFormat", ctypes.c_int),
        ("dwFourCC", wintypes.DWORD),
        ("InputSampleFreq", VMR9Frequency),
        ("OutputFrameFreq", VMR9Frequency),
    ]
#[repr(C)]
pub struct VMR9Frequency {
    pub dwNumerator: u32,
    pub dwDenominator: u32,
}

#[repr(C)]
pub struct VMR9VideoDesc {
    pub dwSize: u32,
    pub dwSampleWidth: u32,
    pub dwSampleHeight: u32,
    pub SampleFormat: i32,
    pub dwFourCC: u32,
    pub InputSampleFreq: VMR9Frequency,
    pub OutputFrameFreq: VMR9Frequency,
}
import "golang.org/x/sys/windows"

type VMR9Frequency struct {
	dwNumerator uint32
	dwDenominator uint32
}

type VMR9VideoDesc struct {
	dwSize uint32
	dwSampleWidth uint32
	dwSampleHeight uint32
	SampleFormat int32
	dwFourCC uint32
	InputSampleFreq VMR9Frequency
	OutputFrameFreq VMR9Frequency
}
type
  VMR9Frequency = record
    dwNumerator: DWORD;
    dwDenominator: DWORD;
  end;

  VMR9VideoDesc = record
    dwSize: DWORD;
    dwSampleWidth: DWORD;
    dwSampleHeight: DWORD;
    SampleFormat: Integer;
    dwFourCC: DWORD;
    InputSampleFreq: VMR9Frequency;
    OutputFrameFreq: VMR9Frequency;
  end;
const VMR9Frequency = extern struct {
    dwNumerator: u32,
    dwDenominator: u32,
};

const VMR9VideoDesc = extern struct {
    dwSize: u32,
    dwSampleWidth: u32,
    dwSampleHeight: u32,
    SampleFormat: i32,
    dwFourCC: u32,
    InputSampleFreq: VMR9Frequency,
    OutputFrameFreq: VMR9Frequency,
};
type
  VMR9Frequency {.bycopy.} = object
    dwNumerator: uint32
    dwDenominator: uint32

  VMR9VideoDesc {.bycopy.} = object
    dwSize: uint32
    dwSampleWidth: uint32
    dwSampleHeight: uint32
    SampleFormat: int32
    dwFourCC: uint32
    InputSampleFreq: VMR9Frequency
    OutputFrameFreq: VMR9Frequency
struct VMR9Frequency
{
    uint dwNumerator;
    uint dwDenominator;
}

struct VMR9VideoDesc
{
    uint dwSize;
    uint dwSampleWidth;
    uint dwSampleHeight;
    int SampleFormat;
    uint dwFourCC;
    VMR9Frequency InputSampleFreq;
    VMR9Frequency OutputFrameFreq;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VMR9VideoDesc サイズ: 36 バイト(x64)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwSampleWidth : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwSampleHeight : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; SampleFormat : VMR9_SampleFormat (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwFourCC : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; InputSampleFreq : VMR9Frequency (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; OutputFrameFreq : VMR9Frequency (+28, 8byte)  varptr(st)+28 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global VMR9Frequency
    #field int dwNumerator
    #field int dwDenominator
#endstruct

#defstruct global VMR9VideoDesc
    #field int dwSize
    #field int dwSampleWidth
    #field int dwSampleHeight
    #field int SampleFormat
    #field int dwFourCC
    #field VMR9Frequency InputSampleFreq
    #field VMR9Frequency OutputFrameFreq
#endstruct

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