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

ANALOGVIDEOINFO

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

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

フィールド

フィールドサイズx64x86説明
rcSourceRECT16+0+0ソースビデオの矩形です。
rcTargetRECT16+16+16転送先のターゲット矩形です。
dwActiveWidthDWORD4+32+32ソースビデオの幅です。
dwActiveHeightDWORD4+36+36ソースビデオの高さです (NTSC では 483、PAL/SECAM では 575)。
AvgTimePerFrameLONGLONG8+40+401 フレームあたりの平均時間 (100 ナノ秒単位) です。

公式ドキュメント

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

ANALOGVIDEOINFO 構造体は、アナログビデオ信号の形式に関する情報を保持します。

解説(Remarks)

この形式を使用するフィルターは、通常、メモリベースのトランスポートではなくハードウェアベースの接続を使用してビデオ信号を受け渡します。

アナログビデオのメディアタイプ接続の定義例としては、"M" カラーエンコードを使用する NTSC ビデオの接続が挙げられます。この場合、主メディアタイプに MEDIATYPE_AnalogVideo、サブタイプに MEDIASUBTYPE_AnalogVideo_NTSC_M、フォーマットタイプに FORMAT_AnalogVideo を使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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;

// ANALOGVIDEOINFO  (x64 48 / x86 48 バイト)
typedef struct ANALOGVIDEOINFO {
    RECT rcSource;
    RECT rcTarget;
    DWORD dwActiveWidth;
    DWORD dwActiveHeight;
    LONGLONG AvgTimePerFrame;
} ANALOGVIDEOINFO;
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 ANALOGVIDEOINFO
{
    public RECT rcSource;
    public RECT rcTarget;
    public uint dwActiveWidth;
    public uint dwActiveHeight;
    public long AvgTimePerFrame;
}
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 ANALOGVIDEOINFO
    Public rcSource As RECT
    Public rcTarget As RECT
    Public dwActiveWidth As UInteger
    Public dwActiveHeight As UInteger
    Public AvgTimePerFrame As Long
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 ANALOGVIDEOINFO(ctypes.Structure):
    _fields_ = [
        ("rcSource", RECT),
        ("rcTarget", RECT),
        ("dwActiveWidth", wintypes.DWORD),
        ("dwActiveHeight", wintypes.DWORD),
        ("AvgTimePerFrame", ctypes.c_longlong),
    ]
#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C)]
pub struct ANALOGVIDEOINFO {
    pub rcSource: RECT,
    pub rcTarget: RECT,
    pub dwActiveWidth: u32,
    pub dwActiveHeight: u32,
    pub AvgTimePerFrame: i64,
}
import "golang.org/x/sys/windows"

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

type ANALOGVIDEOINFO struct {
	rcSource RECT
	rcTarget RECT
	dwActiveWidth uint32
	dwActiveHeight uint32
	AvgTimePerFrame int64
}
type
  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  ANALOGVIDEOINFO = record
    rcSource: RECT;
    rcTarget: RECT;
    dwActiveWidth: DWORD;
    dwActiveHeight: DWORD;
    AvgTimePerFrame: Int64;
  end;
const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const ANALOGVIDEOINFO = extern struct {
    rcSource: RECT,
    rcTarget: RECT,
    dwActiveWidth: u32,
    dwActiveHeight: u32,
    AvgTimePerFrame: i64,
};
type
  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  ANALOGVIDEOINFO {.bycopy.} = object
    rcSource: RECT
    rcTarget: RECT
    dwActiveWidth: uint32
    dwActiveHeight: uint32
    AvgTimePerFrame: int64
struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

struct ANALOGVIDEOINFO
{
    RECT rcSource;
    RECT rcTarget;
    uint dwActiveWidth;
    uint dwActiveHeight;
    long AvgTimePerFrame;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ANALOGVIDEOINFO サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; rcSource : RECT (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; rcTarget : RECT (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; dwActiveWidth : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwActiveHeight : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; AvgTimePerFrame : LONGLONG (+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 どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global ANALOGVIDEOINFO
    #field RECT rcSource
    #field RECT rcTarget
    #field int dwActiveWidth
    #field int dwActiveHeight
    #field int64 AvgTimePerFrame
#endstruct

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